Facilities for Series 200, 300 and 500 
HP-UX Concepts and Tutorials 

HP 9000 Computers 


HP Part Number 97089-90081 



HEWLETT 

PACKARD 



Hewlett-Packard Company 

3404 East Harmony Road, Fort Collins, Colorado 80525 



NOTICE 

The information contained in this document is subject to change without notice. 

HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MANUAL, INCLUDING, BUT NOT LIMITED TO, 
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable 
for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, 
or use of this material. " 

WARRANTY 

A copy of the specific warranty terms applicable to your Hewlett-Packard product and replacement parts can be obtained from your local 
Sales and Service Office. 


Copyright 1985, 1986 Hewlett-Packard Company 

This document contains proprietary information which is protected by copyright. All rights are reserved. No part of this document may be 
photocopied, reproduced or translated to another language without the prior written consent of Hewlett-Packard Company. The information 
contained in this document is subject to change without notice. 

Restricted Rights Legend 

Use, duplication or disclosure by the Government is subject to restrictions as set forth in paragraph (b)(3)(B) of the Rights in Technical Data and 
Software clause in DAR 7-104.9(a). 

Copyright 1980, 1984, AT&T, Inc. 

Copyright 1979, 1980, 1983, The Regents of the University of California. 

This software and documentation is based in part on the Fourth Berkeley Software Distribution under license from the Regents of the University 
of California. 


ii 






Hewlett-Packard is in the process of changing the color of our documentation binders. In order 
to accomplish this changeover we are placing two spine inserts with this manual. Please use the 
insert that matches the binders you receive. 


Hewlett-Packard Company • 3404 East Harmony Road • Fort Collins, Colorado 80525 


Printed in U.S.A. 







Printing History 


New editions of this manual will incorporate all material updated since the previous edition. 
Update packages may be issued between editions and contain replacement and additional pages 
to be merged into the manual by the user. Each updated page will be indicated by a revision 
date at the bottom of the page. A vertical bar in the margin indicates the changes on each page. 
Note that pages which are rearranged due to changes on a previous page are not considered 
revised. 

The manual printing date and part number indicate its current edition. The printing date changes 
when a new edition is printed. (Minor corrections and updates which are incorporated at reprint 
do not cause the date to change.) The manual part number changes when extensive technical 
changes are incorporated. 

November 1985...Edition 1 - Vol. 7: Facilities for Series 200, 300, and 500 
July 1986...Update 

November 1986...Edition 2 - Update incorporated 


iii 




IV 



Table of Contents 


The Series 200 ITE as System Console 

Overview of Article. 1 

Description of the ITE. 2 

Keyboard Requirements. 2 

Description of a System Console. 3 

Additional Considerations . 4 

Using the Keyboard. 6 

Character Entry Group . 7 

Numeric Group. 8 

Display Control Group. 8 

Edit Group. 13 

Function Key Group. 14 

System Control Group. 22 

The Display. 24 

Memory Addressing Scheme. 24 

Cursor Sensing. 26 

Cursor Positioning. 27 

Screen Relative Addressing. 27 

Absolute Addressing. 28 

Cursor Relative Addressing. 29 

Combining Absolute and Relative Addressing. 30 

Display Enhancements. 31 

Raster Control. 32 

Accessing Color. 32 

Configuring the ITE. 37 

Configuration Function Keys. 37 

Terminal Configuration Menu. 38 

ITE Escape Sequences. 46 

Sequence Types. 46 

Keyboard Diagrams for Other Languages. 52 

HP 98203B Keyboards. 52 


i 



































The Series 200 ITE 
as System Console 


Overview of Article 

This article provides you with a description of the ITE as system console for Series 200 com¬ 
puters. If you have a Series 200 computer and you are using it as a terminal connected to an 
HP-UX system, you need to read the “Terminal Emulator Manual” for the particular terminal 
your computer is to emulate. 

The topics this article covers are as follows: 

• Description of the ITE 

• Using the Keyboard 

• The Display 

• ITE Configuration 

• ITE Escape Sequences 


NOTE 

This article docs not cover the HP46020A keyboard that is used by 
the Model 217 and 237 computers. For information on this keyboard 
read the article, “The Series 300 ITE as System Console” found in the 
manual, HP-UX Concepts and Tutorials, Vol. 7. 
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Description of the ITE 

The Internal Terminal Emulator (ITE) consist of “device driver” code contained in the HP-UX 
kernel and associated with the built-in keyboard and monitor on a Series 200 computer with 
memory management. Memory management means the computer contains a central processing 
unit designed to run the HP-UX system. Your particular keyboard and monitor combination 
are considered to be an ITE if they meet one requirement given in the section, “Keyboard 
Requirements” and one requirement given in the section, “Monitor Requirements”. 

Keyboard Requirements 

The keyboard you are using is considered to be an ITE keyboard if it is an: 

• HP Model 226 or Model 236 built-in keyboard, 

• HP98203B (Large Keyboard) connected to a Keyboard/HP-IB Interface card (HP part 
number 09920-66533 or 09920-66534), 

• HP 46020A keyboard connected to a Model 217 or Model 237. The use of this keyboard 
is covered in the HP-UX Concepts and Tutorials, Vol. 7 article, “The Series 300 ITE as 
System Console”. 

Monitor Requirements 

The monitor you are using is considered to be an ITE monitor if it is an: 

• HP Model 226 or Model 236 built-in monitor, 

• HP 82912A or HP 82913A monitor connected to an HP 98204A video board, 

• HP 35721A/B/C or HP 35731A/B monitor connected to an HP 98204B video board, 

• HP 98781A high resolution monochromatic (black and white) monitor used with a Model 
237. 
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Description of a System Consoie 

The system console is a keyboard and monitor (or terminal) given a unique status by HP-UX 
and associated with the special (device) file /dev/console. All boot ROM error messages, HP-UX 
system error messages, and certain system status messages are sent to the system console. 
Under certain conditions (for example, the single-user state), the system console provides the 
only mechanism for communicating with HP-UX. 

The boot ROM and HP-UX operating system assign the system console function according to a 
prioritized search sequence. HP-UX’s search for a system console terminates as soon as one of 
the following conditions is met: 

• A built-in serial interface card, HP 98626A, HP98628A1, HP 98642A\ or HP98644A 
RS-232C serial interface is present with the “remote bit”^ set. If more than one is present, 
the one with the lowest select code is used. In the case of the HP 98642A (4-channel 
multiplexer), port 1 is used. 


• A Model 237 is present or an HP 98700H Display Station is present with its HP 98287A 
Display Station Interface card configured for “internal” control space. Note that if the 
HP 98700H display station’s display interface card (HP 98287A) is configured for “exter¬ 
nal” control, it is never chosen (“external” bit-mapped displays have a specific select code 
address and “internal” bit-mapped displays do not). There are two things you should note 
about the “internal” HP98700H Display Station: 

• it is not supported as a boot device on the Series 200 Revision 3.0 or 4.0 boot 
ROM. In this case, boot ROM messages would be displayed on the next console 
found, but HP-UX messages would be displayed on the HP 98700H Display Station. 

• it cannot exist “internally” with a Model 237 because the display addresses of both 
devices collide. 

• An HP 98204A/B compatibility video interface or an internal alpha display (e.g. Model 
236 display) is present. 


The HP98628A Datacomm Interface Card and the HP98642A 4-channel Multiplexer Interface with their “remote bit” set are not 
supported as remote consoles by the Revision A boot ROM; however, it is supported as the system console by the HP-UX operating 
system. Therefore, when an HP 98628A or HP 98642A card is used and has its “remote bit” set, the boot ROM sends messages to the 
next console found, but HP-UX sends its messages to the ITE (terminal) associated with the HP 98628A or HP 98642A card. 

On the HP 98626A Serial Interface board the remote bit is set by cutting a jumper as described in the installation manual supplied with 
your computer. On the HP 98628A Datacomm Interface card the remote bit is set by setting a switch on the board as described in that 
board’s installation manual. 
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• A built-in serial interface, HP 98626A, HP 98628A, HP 98642A, or HP 98644A RS-232C 
serial interface is present without the “remote bit” set. If more than one is present, the one 
with the lowest select code is used. In the case of the HP 98642A (4-channel multiplexer), 
port 1 is used. The boot ROM does not recognize the serial interface card as console 
when this condition is met; however, HP-UX does. 

If none of the above conditions are met, no system console exists. While the boot ROM tolerates 
this, HP-UX will not. 


NOTE 

To install the HP-UX system it is necessary to communicate with the 
boot ROM. Because the boot ROM will not use a terminal connected to 
an HP 98628A Datacomm Interface card or an HP 98642A RS-232C 
Multiplexer card as its display, HP-UX must be installed using either the 
computer’s ITE hardware, an HP 98626A Serial Interface card, or an 
HP 98644A Serial Interface card. 


Additional Considerations 

This section contains information on bit settings for the HP 98626A RS-232C Serial Interface 
Card’s Line Control Switch Pack. 

The boot ROM requires that the Line Control Switch Pack settings on the HP 98626A RS-232C 
Serial Interface card be set to the same setting as your ITE (terminal). HP-UX resets these values 
to system defaults on log in. These values are as follows: 


StopBits 

should be set to 1. 

BaudRate 

should be set to 9600 bps. 

Parity/DataBits 

should be set to O’s/7. 

Enq/Ack 

should be set to NO. 

Pace 

should be set to XON/XOFF. 

(Handshake) 
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To make the above settings on your HP 98626A Serial Interface card, set your cards Line 
Control Switch Pack (U-2) switches as follows: 


bit 0 

bit 1 

bit 2 

bits 

bit 4 

bit 5 

bit 6 

bit 7 

1 

1 

0 

0 

1 

0 

1 

0 


Additional settings for Handshake Type bits 6 and 7 of the Line Control Switch Pack, not 
described in the HP 98626A installation manual, are: 


Bit 6 

Bit 7 

Handshake Type 

0 

0 

ENQ/ACK 

1 

0 

XON/XOFF 

0 

1 

NO HANDSHAKE 

1 

1 

NO HANDSHAKE 


Note that other switch settings for the Line Control Switch Pack on the HP 98626A card are 
defined in the installation manual supplied with that card. 
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Using the Keyboard 

The Series 200 computer keyboard is divided into six functional groups: 
e Character Entry Group, 
e Numeric Group, 

• Display Control Group, 
e Edit Group, 

e Function Key Group, 
e System Control Group. 

The remainder of this section covers these key groups. 

The keyboard overlay supplied with your Series 200 computer allows you to convert it for use 
as an HP-UX system console keyboard. The key labels on the overlay are color-coded as follows: 

• Shifted keys are light blue with the exception of four US/KATA keys. The US/KATA 
keys and their functions are covered in the “Function Key Group” section. On the overlay, 
the keys are labeled from left to right: ‘, |, \, and 

• Unshifted keys are dark brown; 

• Control keys are orange; 

• Shifted US/KATA keys are dark blue. 
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US ASCII Keyboard and Overlay 

If you are using the HP46020A keyboard with a Model 217 or 237 computer, you can find 
an explanation of its keys in the article, “The Series 300 ITE as System Console” found in the 
manual, HP-UX Concepts and Tutorials, Vol. 7. 

Character Entry Group 

The character entry keys are arranged like a typewriter, but have some added features. 


I SHIFT I gives you uppercase letters when you are typing in lowercase (caps lock 

off). When you are typing in uppercase (caps lock on) , this key will give 
you lowercase letters. 


[CAPS LOCK I 


R 

E 

I enter I J 

R 

N 

rwi 


sets the unshifted keyboard to either uppercase (the power-on default) or 
lowercase (normal typewriter operation) letters. 

sends the ReturnDef sequence to the computer (the default is to send Si). 
When a program is running, this key is used to input information requested 
by the computer. 

sends a tab character (CTRL-I) to the computer. 


I CTRL I 


provides access to the standard ASCII control characters. 


I BACK SPACE I sends the back space character (CTRL-H) to the computer in the remote 
mode, and in the local mode it moves the cursor one space to the left. 
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Numeric Group 

The numeric group of keys is located to the right of the character keys. The layout of the 
numeric key pad is similar to that of a standard office calculator. These keys are convenient for 
high-speed entry of numeric data. 

The numeric key pad on Series 200 computers also provides the non-US ASCII keyboard user 
with a few of the character keys not found on their keyboard. These characters are accessed by 
holding the shift key down and pressing the appropriate numeric key, as shown in the following 
diagram. 

0 □ □ □ 


# ^ @ 



E] 0 0 0 


0 0 0 0 

0 0 0 0 

Additional Numeric Key Pad Characters 

Display Control Group 

The display control group consists of the keys that control the location of the cursor on the 
display. Each display control key and its function is described in the sections that follow. 

Setting and Clearing Tab Stops 

You can define and delete a series of tab stops by using the following tab functions. 

SET TAB sets tab stops. To set a tab stop move the cursor to the desired location, 

shift— I RESULT I hold the | SHIFT | key down, and press SET TAB. 

CLR TAB deletes individual tab stops. To delete tab stops, move the cursor to the 

I PRT ALL 1 tab position which you want to remove, hold the | SHIFT | key down, and 

press 

CLR TAB. 
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Cursor Control 

To use the knob (cursor control wheel) and arrow keys, either have the transmit functions 
mode disabled or be in a program or command, such as vi or ex, which understand and enable 
these keys. The transmit functions mode specifies whether escape code functions are executed 
locally at the terminal (ITE) or transmitted to the computer. When the system is shipped the 
default for this mode is NO. In the vi or ex editor, the arrow keys and knob can be used as 
described in this section; however, continuously holding an arrow key down or rapidly spinning 
the knob is discouraged^. To disable the transmit functions mode: 


press: f9 (labeled AIDS on the overlay) 



Use of the knob or arrow keys is not recommended in the vi editor. On busy systems an escape character created by the knob or arrow 
keys, while in the ui editor, can be lost and misinterpreted by the system. This may result in the loss of data on a given line. 
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press: f5 (terminal) 


When a screen display similar to the one shown below appears, press the | TAB | key until the 
cursor is positioned just after XmitFnctn(A). 


TERMINAL CONFIGURATION 



Language USASCII 
ReturnDef Cr 

LocalEcho OFF CapsLock OFF Ascii 8 Bit NO 

XmitFnctn(A) NO InhEolWrp(C) NO 




NEXT 







If the word following the label is NO, then the transmit functions mode is not active, 
press: f8 (config) 

to return to the HP-UX environment. If the word following the XmitFnctn(A) label is a YES, 
then 

press: f2 (NEXT) 
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This turns off the transmit function mode. 


press: f1 (SAVE CFG) 

This returns you to the shell environment. 

When the transmit functions mode is off, there are four keys used to change the location of the 
cursor in the shell environment: 

E moves the cursor up in the output area of the display screen. 

rri moves the cursor down in the output area of the display screen. 

moves the cursor to the left in the output area of the display screen. 
r«n moves the cursor to the right in the output area of the display screen. 

These same keys, when used with the | SHIFT | key, enable you to scroll up and down through 
the screen display and to move the cursor to its upper or lower home position. These keys are 
listed as follows: 

ROLL DOWN 

shift- [T] 

ROLL UP 

shift- [J] 

shift- 

shift- rn 

Another method used to move the cursor is the knob. Rotating the knob either clockwise or 
counter-clockwise moves the cursor horizontally. Rotating the knob while pushing the | SHIFT | 
key moves the cursor vertically until the top or bottom of the display screen is reached, at that 
time the screen display rolls up or down in display to the next page or previous page. Note that 
use of the knob is not recommended in the ui editor. 

The [ recall I key has been redefined to allow you to move to the next or previous page. 

I RECALL I moves you back a page within your text. 

PREV PAGE 

NEXT PAGE moves you forward a page within your text, 
shift — I RECALL I 


scrolls the screen display downward, 
scrolls the screen display upward, 
moves the cursor to its upper home position, 
moves the cursor to its lower home position. 
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What is the next page or previous page? Data in display memory can be accessed (displayed 
on the screen) in blocks that are known as “pages”. A page consists of 24 lines of data (23 
lines for a Model 226 and 47 lines for a Model 237 high resolution monitor). The current page 
is that sequence of lines which appears on the screen at any given time. The previous page is 
the preceding 23/24/47 lines in display memory. The next page is the succeeding 23/24/47 
lines in display memory. This concept, along with the concept of rolling data through the display 
screen and memory, are shown in the following illustrations. 



ROLLUP ROLL DOWN 


The “Roll Up and Roll Down” Functions 
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LINE 1 


LINE 1 


a.J 


DISPLAY 


LINES 1 


SCREEN 


4 


1 NEXT 1 


LINES 1 


1 PAGE 1 


1 

1_1 


f 

1-1 

24 J 


PREVIOUS 


LINES 1 


PAGE 


4 


DISPLAY 


LINES 1 


SCREEN 



DISPLAY CONTROL 
DISPUVY MEMORY 
100 LINES 

80 CHARACTERS/LINE 


LINE 100 


LINE 100 


Previous Page and Next Page Concepts 


Edit Group 

The edit group consists of the keys that allow you to modify the data presented on the screen. 
However, the edited data cannot be read back by the system. Typically these features are used 
to modify text within a program or file, to view data which has scrolled out of the screen window 
and to clear the screen. 

To use these features in the vi editor, you should have an .exrc file in your $HOME directory 
which maps these keys to their function using escape code sequences. Reference to this file is 
made in the HP-UX S};stem Administrator Manual and in “The Vi Editor” selected article. 


NOTE 

Using these keys while in the vi editor without an .exrc file can cause 
loss of important data. 
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All line edit keys and character edit keys function as stated below: 


I CLR-^END I 

I INS LN I 


I DEL LN I 


I CLR LN I 
I INS CHR I 


clears the characters in a line from the present cursor position to 
the end of the line. 

causes the line containing the cursor and all text lines below it to 
move down one line, and a blank line to be inserted in the row 
containing the cursor. The cursor will move to the left margin of 
the blank line. 

deletes the line containing the cursor from display memory. All text 
lines below this line will roll up one row, and the cursor will move 
to the left margin. 

performs the same function as | CLR-^ENdI . 

sets the insert mode, allowing you to insert characters to the left of 
the cursor. 


I DEL CHR I deletes the character at the cursor. 

DEL sends the DEL character to the computer, 

shift— I BACK SPACE | 


Function Key Group 

In the upper left-hand corner of your keyboard next to the knob are a set of ten function keys. 
HP-UX recognizes only eight function keys: f1 through f8. The remaining keys are used as 
“AIDS” keys which will be discussed later in this section. The functions performed by these keys 
change dynamically as you use the computer. At any given time the applicable function labels 
for these keys appear across the bottom of the display screen. 
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The function key group also includes the US/KATA keys which are accessed using the numeric 
key pad. These keys are very useful when using HP-UX and they have been given the following 
names: 


i 

shift—1 E 1 

left apostrophe. 

1 

shift—[T] 

vertical bar. 

\ 

shift—[T] 

backslash^. 

shift—1 ^ 1 

tilde. 


The remainder of this section covers the relationship of the eight function keys, f1 through f8, 
to the overlay functions: MODES, AIDS and USER KEYS. 

M 

I RUN I D allows access to one of the modes described in the following sections. An 
example of the function key display is given: 





4 


This same key sequence returns the yen ( y ) character when the ITE is configured to use the KATAKANA language. See later section 
of this article entitled, “Configuring the ITE”. 
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You may use these function keys to enable and disable various terminal operating modes. Each 
defined mode selection key alternately enables, and disables a particular mode. When the mode 
is enabled, an asterisk (*) appears in the associated key label on the screen, as seen in the 
REMOTE key label above. 

When the remote mode is enabled and a key is pressed, the terminal transmits the associated 
ASCII code to HP-UX. In local mode (remote mode is disabled), when a character key is pressed, 
the associated character is displayed at the current cursor position on the screen and nothing is 
transmitted to HP-UX. 

When the auto line feed mode (AUTO LF) is enabled, an ASCII line feed control code is auto¬ 
matically appended to each ASCII carriage-return control code generated through the keyboard. 
ASCII carriage-return control codes can be generated through the keyboard in any of the following 
ways: 

• By pressing RETURN. 

• By holding down CRTL and pressing | M | . 

• By pressing any of the user keys f1 through f8, provided that a carriage-return code is 
included in the particular key definition. 

When the display functions mode is enabled, the ITE displays ASCII control codes, and escape 
sequences but does not execute them (except for %). 


I k9 I provides another menu in the display, showing three general control keys: 



tab/mrgn pressing this softkey provides another menu with: SET TAB, CLR TAB, and 
CLR TABS. The first two softkey functions were previously defined in the 
display control group section. The last softkey CLR TABS when pressed 
clears all tab stops currently set. 
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modes 


allows access to the remote mode, auto line feed mode, and display func¬ 
tions mode. These modes were previously described in this section. Press¬ 
ing the function key f4 or the | RUN | key labeled MODES on the keyboard 
overlay, you will obtain the following function key labels: 



FlexDisc pressing this softkey (this only applies to the Model 226 and Model 236 

computers) provides another menu with these labels: fd.l and fd.O. When¬ 
ever this symbol * appears in the label block, the internal disc drive 1 (left 
drive) or 0 (right drive) is in use. 

conf ig pressing this softkey provides another menu with only the softkey [terminal] 

in it. If you press this softkey, you get the TERMINAL CONFIGURATION 
display on your screen as described in the display control group section of 
this article. 

CLR AIDS clears the screen display of the function key labels. The user function keys, 
I k4 I however, are still enabled. 

I EXECUTE I not implemented; however, it does return a beep. 

ENTER 


I CONTINUE I displays eight function keys which can be defined either locally by the user 

USER KEYS or remotely a program executing in a host computer. By “defined” it is 

meant: 


• You can assign to each key a string of ASCII alphanumeric characters and/or control codes 
(such as carriage return or line feed). 

• You can specify each key’s operational attribute: whether its key definition is to be exe¬ 
cuted locally at the terminal, transmitted to the computer, or both. 

• You can assign to each key an alphanumeric label (up to 8 characters) which, in user keys 
mode, is displayed across the bottom of the screen. 
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Defining User Keys Locally 

When defining a key from the keyboard, the key content may include explicit escape sequences 
(entered using display functions mode) that control or modify the ITE’s operation. 

The definition of each user key may contain up to 80 characters (alphanumeric characters, ASCII 
control characters, and explicit escape sequence characters). 


To define USER KEYS locally (from the keyboard), press the | SHIFT | and | CONTINUE 
(USER KEYS) keys simultaneously. The following user keys menu will appear: 



This menu contains the default values for all of the fields. If your screen does not contain the 
default values as shown and you want them set and displayed press f4 (DEFAULT). 

The menu contains a set of fields that you access using the | TAB | key. 
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For each user key the menu contains three unprotected fields: 

ATTRIBUTE FIELD — This one character field always contains an uppercase L, T, or N signifying 
whether the content of the particular user key is to be: 

L Executed locally only, 

T Transmitted to the host computer only. 

N Treated in the same manner as the alphanumeric keys. If the ITE is in local mode, the 
content of the key is executed locally. If the ITE is in the remote mode and LocalEcho 
is disabled (OFF), the content of the key is transmitted to the computer. If the ITE is in 
remote mode and local echo is enabled (ON), the content of the key is both transmitted 
to the host computer and executed locally. 

The alphanumeric keys are disabled when the cursor is positioned in this field. You change the 
content of this field by pressing f2 (NEXT) or f3 (PREVIOUS). 

LABEL FIELD — This eight-character field to the right of the word “LABEL” allows you to 
supply the user key’s label. When the ITE is in user keys mode, the key labels are displayed 
from left to right in ascending order across the bottom of the screen. 

KEY DEFINITION FIELD — The entire line (80 characters) immediately below the attribute and 
label field is available for specifying the character string that is to be displayed, executed, and/or 
transmitted whenever the particular key is physically pressed. 

When entering characters into the key definition field you may use the display functions mode. 
Note that this implementation of display functions mode is separate from that which is en¬ 
abled/disabled via the mode selection keys. When entering the label and key definition you may 
access display functions mode by way of function key f7 (DSPY FN) on Model 226, Model 236, 
and HP 46020A keyboards. 

The I ENTER I (RETURN) key can be used to include carriage return (Si) codes (with display 
functions mode enabled) in key definitions. If auto line feed mode is also enabled, the | ENTER | 
(RETURN) key will generate a Si S', otherwise it is considered a cursor movement key. Note 
that I CTRL Hn generates a S code. 

When the user keys menu is displayed on the screen you may use the | INS CHR~1 , | DEL CHfT] 
and I CLR LN | keys for editing the contents of the label and key definition fields. 

When you are finished defining all the desired keys, press the | k9 | (AIDS), I RUN | (MODES) or 
I CONTI Null (USER KEYS) key (in all three cases the user keys menu disappears from the screen). 
When you press | CONTINUeI (USER KEYS), the defined user key labels are displayed across the 
bottom of the screen and the f1 through f8 user keys, as defined by you, are enabled. 
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Defining User Keys Programmatically 

From a program executing in a host computer, you can define one or more keys using the 
following escape sequence format: 

<attribute><key><label lengthXstring length><label><string> 

where: 

$<$attribute$>$ = Oa : normal (N) (0 is the default) 
la : local only (L) 

2a : transmit only (T) 


$<$key$>$ = l-8k : fl-f8, (1 is the default) 

respectively 


$<$label lengths>$ = 0-16d (0 is the default) 

$<$string length$>$= 0-80L (1 is the default) 

(-1 causes field to be erased) 

The < attribute >, <key>, < label length>, and < string length > parameters may appear in any 
sequence but must precede the label and key definition strings. You must use an uppercase 
identifier (A, K, D, or L) for the final parameter and a lowercase identifier (a, k, d, or 1) for 
all preceding parameters. Following the parameters, the first 0 through 16 characters, as 
designated by <label length>, constitute the key’s label; however, only the first 8 characters are 
recognized. The next 0 through 80 characters, as designated by <string length>, constitute the 
key’s definition string. The total number of displayable characters (alphanumeric data, ASCII 
control codes such as ^ and S’, and explicit escape sequence characters) in the label string must 
not exceed 16, and in the definition string must not exceed 80. 

Example: Assign login as the label and TOM as the definition for the f5 user key. The user key 
(f5) is to have attribute “N”. Note that S&jB is the escape sequence used in this example to 
turn on the user key labels. 

S&f 0a5k5d3LloginT0MS& j B 
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After issuing the foregoing escape sequence from your program to the terminal, the f5 portion 
of the user keys menu is as follows: 

f5 N LABEL login 
TOM 

If the transmit only attribute (2) is designated, the particular user key will have no effect unless 
the terminal is in remote. 

Controlling the Function Key Labels Programmatically 

From a program executing in a host computer, you can control the the function key labels display 
as follows by using escape sequences: 

• You can remove the key labels from the screen entirely (this is the equivalent to pressing 

(CLR AIDS). 

• You can enable the mode selection keys (this is the equivalent of pressing the | RUN | 
(MODES) key). 

• You can enable the user keys (this is the equivalent of pressing the | CONTI Null 

(USER KEYS) key). 

The escape sequences are as follows: 

Enables the user keys and remove all key labels from the screen. 

^&jA Enables the modes key. 

^&jB Enables the user keys. 
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System Control Group 

These keys are located in the upper-right corner of your keyboard. They control system functions 
related to the display, printer and editing operations. 


I PAUSE I 


E 

S 

C 


generates special ASCII control character number 27 (escape 
character). 


riDm 


not implemented. 


DISPLAY FCTNS enables display functions mode as defined in the function key group, 
shift— I EDIT I Pressing the DISPLAY FCTNS key again cancels the display functions 

mode. 


I ALPHA I These commands work together to control the Alpha and Graphic 

and displays. Pressing the | ALPHA | key toggles the ALPHA display and 

I GRAPHICS I pressing the | GRAPHIC^ key toggles the GRAPHICS display. Both of 

these keys may be enabled at the same time. 


DUMP GRAPHICS not implemented, 
shift — I GRAPHICS I 


DUMP ALPHA 

shift — I ALPHA I 

ANY CHAR 

shift— I STEP I 


not implemented. 


causes the next three characters typed (must be integers) to be inter¬ 
preted as the decimal specifier of an HP extended ASCII character. 


I STEP I 

DISPLAY FCTNS 


enables display functions mode as defined in the function key group. 
Pressing the DISPLAY FCTNS key again cancels the display functions 
mode. 


I CLR LNI 


defined in the Edit Group. 


CLR SCR 

shift — I CLR LN I 


clears the entire alpha portion of the screen display starting from the 
cursor position. 


I RESULT I 


not implemented. 


I PRT ALL I 


not implemented. 


SET TAB 

shift- 1 RESULT I 


sets a tab at the current cursor position. Tabs are in effect in the 
alpha display until cleared by the CLR TAB key or the softkey labeled 


CLR TABS. 
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CLR TAB 

shift— I PRT ALL | 

SOFT RESET 

shift— I CLR I/O I 


HARD RESET 

shift— I PAUSE I 


I CLR I/O I 

BREAK 


clears a tab previously set at the current cursor position. 


does the following: 

• Sounds the computer’s beeper. 

• Disables display functions mode (if enabled). 

The data on the screen, all terminal operating modes (except dis¬ 
play functions mode), and all active configuration parameters are un¬ 
changed. Note that SOFT RESET also: 

• Restores default color maps. 

• Rewrites the whole screen. 

has the same effect as restarting the ITE. A hard reset does the fol¬ 
lowing: 

• Sounds the computer’s beeper. 

• Clears all of alphanumeric memory. 

• Resets the terminal configuration menu parameters to 
their power on values. 

• Resets certain operating modes and parameters as 
follows: 

• Disables display functions mode, and caps mode. 

• Turns off the insert character edit function. 

• Resets the user keys to default values. 

• Turns on the alphanumeric display. 

• Resets color pairs to their default values 

(Model 236 only). 

creates an interrupt signal (SIGINT) which is sent to all processes within 
your terminal (ITE). For information on this signal read the sections 
SIGNAL(2) and TTY(4) in your HP-UX Reference. To learn how to 
use this signal in a shell script read “Bourne Shell Programming” in 
your HP-UX Concepts and Tutorials. 
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The Display 

The Internal Terminal Emulator’s (ITE’s) display has many features of its own, video highlights 
(such as inverse video and blinking), raster control, cursor sensing and addressing, and color 
highlight control (for Series 200 computers equipped with a color display). These functions are 
accessed only through escape sequences and are discussed in the sections that follow. As you 
read this section, note the last letter in an extended escape sequence is always capitalized. An 
extended escape sequence consists of the escape character (ASCII 27) followed by at least two 
subsequent characters. 

Memory Addressing Scheme 

Display memory positions can be addressed using absolute or relative coordinate values. On a 
Series 200 Medium Resolution monitor, display memory is made up of 80 columns (0 thru 79) 
and up to four 24-line pages (100 lines of scrolling) with 80 characters per line. A Model 226 
has a display memory made up of 50 columns (0 thru 49) and up to four 23-line pages (100 
lines of scrolling) with 50 characters per line. On Series 200 High Resolution monitors, display 
memory is made up of 128 columns (0 thru 127) and up to two 47-line pages (100 lines of 
scrolling) with 128 characters per line. The types of addressing available are absolute (memory 
relative), screen relative, and cursor relative. 

Row Addressing 

The figure below illustrates the way that the three types of addressing affect row or line numbers. 
The cursor is shown positioned in the fourth row on the screen. Screen row 0 is currently at 
row 6 of display memory. In order to reposition the cursor to the first line of the screen the 
following three destination rows could be used: 

Absolute: row 6 

Screen Relative: row 0 
Cursor Relative: row -3 
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b.) Screen Relative: row 0 c.) Cursor Relative; row-3 


Row Addressing 


Column Addressing 

Column addressing is accomplished in a manner similar to row addressing. There is no difference 
between screen relative and absolute addressing. The figure below illustrates the difference 
between absolute and cursor relative addressing. The cursor is shown in column 5. 

Whenever the row or column addresses exceed those available, the largest possible value is 
substituted. In screen relative addressing, the cursor cannot be moved to a row position that is 
not currently displayed. For example, in the cursor relative portion of the figure above (showing 
row addressing), a relative row address of -10 would cause the cursor to be positioned at the top 
of the current screen (relative to row -3). Column positions are limited to the available screen 
positions. For example, in the following illustration, the absolute column addressing example 
shows limits of 0 and 79, while the relative column addressing example shows limits of -5 and 
+74. The cursor cannot be wrapped around from column 0 to column 79 by specifying large 
negative values for relative column positions. 
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0 1 2 3 4 5 6 7 8 9 79 


-5 -4 -3 -2 -10 +1 +2 +3 ... -74 




Column Addressing 


Cursor Sensing 

The current position of the screen cursor can be sensed. The position returned can be the 
absolute position in the display memory or the location relative to the current screen position. 

Cursor sensing functions only when the “terminal” is in remote mode. 

Absolute Sensing 

When a program sends the escape sequence to the terminal, the terminal returns to the 
program an escape sequence of the form ^feaxxxcyyyRSl, where xxx is the absolute column 
number and yyy is the absolute row number of the current cursor position. You will later see 
that this escape sequence is identical to the escape sequence for an absolute move of the cursor. 

Relative Sensing 

When a program sends the escape sequence \ ‘, the terminal returns to the program an escape 
sequence of the form ^&a xxxcyyyY^ where xxx is the column number of the cursor and yyy 
is row position of the cursor relative to screen row 0. This escape sequence is identical to the 
escape sequence for a relative move of the cursor (discussed later in this article). 
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Cursor Positioning 

The cursor can be positioned directly by giving memory or screen coordinates, or by sending 
the escape codes for any of the keyboard cursor positioning operations. 

Screen Relative Addressing 

To move the cursor to any character position on the screen, use any of the following escape 
sequences: 

^&a<column number> c <row number>Y 
^&a<row number> y <column number>C 
^&a<column number>C 
^&a<row number >Y 
where: 

< column number> is a decimal number specifying the screen column to which you wish 

to move the cursor. Zero specifies the left-most column. 

<row number> is a decimal number specifying the screen row (0 thru 23) to which 

you wish to move the cursor. Zero specifies the top row of the 
screen; 23 specifies the bottom row. 

When using the escape sequences for screen relative addressing, the data on the screen is 
not affected (the cursor may only be moved around in the 24 rows and 80 columns currently 
displayed, thus data is not scrolled up or down). 

If you specify only <column number>, the cursor remains in the current row. Similarly, if you 
specify only <row number>, the cursor remains in the current column. 

Example 

The following escape sequence moves the cursor to the 20th column of the 7th row on the 
screen: 

%&a6yl9C 
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Absolute Addressing 

You can specify the location of any character within display memory by supplying absolute 
row and column coordinates. To move the cursor to another character position using absolute 
addressing, use any of the following escape sequences: 

^&a<column number> c <row number>R 

^&a<row number > r < column number >C 

^&a<column number>C 

^&a<row number>R 

where: 

< column number> is a decimal number (0 thru 79) specifying the column coordinate 

(within display memory) of the character at which you want the cur¬ 
sor positioned. Zero specifies the first (left-most) column in display 
memory, 79 the right-most column. 

<row number> is a decimal number (0-99) specifying the row coordinate (within 

display memory) of the character at which you want the cursor 
positioned. Zero specifies the first (top) row in display memory, 99 
specifies the last. 

When using the above escape sequences, the data visible on the screen rolls up or down (if 
necessary) in order to position the cursor at the specified data character. The cursor and data 
movement occur as follows: 

• If a specified character position lies within the boundaries of the screen, the cursor moves 
to that position; the data on the screen does not move. 

• If the absolute row coordinate is less than that of the top line currently visible on the 
screen, the cursor moves to the specified column in the top row of the screen; the data 
then rolls down until the specified row appears in the top line of the screen. 

• If the absolute row coordinate exceeds that of the bottom line currently visible on the 
screen, the cursor moves to the specified column in the bottom row of the screen; the 
data then rolls up until the specified row appears in the bottom line of the screen. 

If you specify only a <column number>, the cursor remains in the current row. Similarly, if you 
specify only a <row number>, the cursor remains in the current column. 
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Example 

To position the cursor (rolling the data if necessary) at the character residing in the 60th column 
of the 27th row in display memory, the escape sequence is: 

^&a26r59C 

Cursor Relative Addressing 

You can specify the location of any character within display memory by supplying row and 
column coordinates that are relative to the current cursor position. To move the cursor to 
another character position using cursor relative addressing, use any of the following escape 
sequences: 

^&a ±<column number> c ih<row number>R 
^&a zb < row number> r ±< column number>C 
^&a di<column number>C 
^&a di<row number >R 
where: 

< column number > is a decimal number specifying the relative column to which you 

wish to move the cursor. A positive number specifies how many 
columns to the right you wish to move the cursor; a negative number 
specifies how many columns to the left. 

<row number> is a decimal number specifying the relative row to which you wish 

to move the cursor. A positive number specifies how many rows 
down you wish to move the cursor; a negative number specifies how 
many rows up you wish to move the cursor. 

When using the above escape sequences, the data visible on the screen rolls up or down (if 
necessary) in order to position the cursor at the specified data character. The cursor and data 
movement occur as follows: 

• If a specified character position lies within the boundaries of the screen, the cursor moves 
to that position; the data on the screen does not move. 
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• If the specified cursor relative row precedes the top line currently visible on the screen, 
the cursor moves to the specified column in the top row of the screen; the data then rolls 
down until the specified row appears in the top line of the screen. 

• If the specified cursor relative row exceeds the bottom line currently visible on the screen, 
the cursor moves to the specified column in the bottom row of the screen; the data then 
rolls up until the specified row appears in the bottom line of the screen. 

If you specify only a <column number>, the cursor remains in the current row. Similarly, if you 
specify only a <row number>, the cursor remains in the current column. 

Example 

To position the cursor (rolling the data if necessary) at the character residing 15 columns to the 
right and 25 rows above the current cursor position (within display memory), use the escape 
sequence: 

^&a+15c-25R 

Combining Absolute and Relative Addressing 

You may use a combination of screen relative, absolute and cursor relative addressing within a 
single escape sequence. 

For example, to move the cursor (and roll the text if necessary) so that it is positioned at the 
character residing in the 70th column of the 18th row below the current cursor position, use 
the escape sequence: 

^&a69c+18R 

Next, to move the cursor so that it is positioned at the character residing 15 columns to the 
left of the current cursor position in the 4th row currently visible on the screen, use the escape 
sequence: 

^&a-15c 3Y 

Similarly, to move the cursor (and roll the text up or down if necessary) so that it is positioned at 
the character residing in the 10th column of absolute row 48 in display memory, use the escape 
sequence: 

^&a9c 47R 
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Display Enhancements 

The terminal includes as a standard feature the following display enhancement capabilities: 

• Inverse Video - black characters are displayed against a white background. 

• Underline Video - characters are underscored. 


NOTE 

The Model 226 computer does not provide display enhancements. The 
Model 220 computer with an HP 98204A composite video card does 
not provide display enhancements. 


The display enhancements are used on a field basis. The field can not span more than one line. 
The field scrolls with display memory. Overwriting a displayable character in a field preserves 
the display enhancement. The enhancements may be used separately or in any combination. 
When used, they cause control bits to be set within display memory. 

From a program or from the keyboard, you enable and disable the various video enhancements 
by embedding escape sequences within the data. The general form of the escape sequence is: 

^&d< enhancement code> 

where enhancement code is one of the uppercase letters A through O specifying the desired 
enhancement(s) or an @ to specify end of enhancement: 



@ 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

Underline 





X 

X 

X 

X 





X 

X 

X 

X 

Inverse Video 



X 

X 



X 

X 



X 

X 



X 

X 

End Enhancement 

X 

















Enhancement Character 


Note that the escape sequence for “end enhancement” ft&d@) or the escape sequence for 
another video enhancement, ends the previous enhancement. 
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Raster Control 

The terminal provides the ability to enable and disable the alphanumeric display. The escape 
sequences for these capabilities are: 

^*dE Restores the alphanumeric display; enables writing to the alphanumeric display (this 
returns the screen, on bit-mapped displays). 

^*dF Disables further writing to the alphanumeric display (this inhibits any further output 
with bit-mapped displays). 

Accessing Color 

The monitor used for accessing color is the built-in color monitor of the Model 236. To access 
color on a Series 200 computer, you must understand some simple terms. 

Color pair - two colors which define the foreground color (color of the characters) and the 
background color, respectively. 

For Model 236 computers at least one of the color pairs must be black; displaying color on color 
is not possible. A total of 64 color pairs are possible, but only eight can be displayed at any 
one time. Note that this is not true for a bit-mapped color display. 

Pen # - one of eight predefined color pairs. Pen 0 through pen 7 are initially defined as follows 
(re-defining a color pair is described later): 


Pen # 

Foreground 

Color 

Background 

Color 

0 

white 

black 

1 

red 

black 


green 

black 


yellow 

black 


blue 

black 


magenta 

black 


cyan 

black 


black 

yellow 


Pen #0 is the default pen selected by the terminal when writing to the display. 
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Selecting a Pen (Color Pair) 

By using an escape sequence, you can select a pen number other than pen #0 when writing 
to the display. Like other display enhancements, pen selection is used on a field basis. The 
field cannot span more than one line. That is, the pen selection is only active until a new-line 
character is encountered; then the default pen is re-selected. The escape sequence for selecting 
a pen is: 

^&v <n> <parameter> 
where: 

<n> is the pen number, 

<parameter> is a single character that specifies the action. 

To select a pre-defined pen number, the necessary <parameter> is S. Thus, 

4S 

selects the pre-defined pen number 4. 

Changing Pen Definitions 

You may change the pre-defined color pair for any of the eight existing display pens. The three 
primary colors (red, green and blue) are used in various combinations to achieve the desired 
color. 

The combinations of red, green, and blue that define foreground and background colors can 
be specified in two notations. The first is RGB (Red-Green-Blue), and the second is HSL (Hue- 
Saturation-Luminosity). The notation must be selected before you can redefine pens (if no 
notation type is specified, the “ITE” uses the last notation specified, or RGB notation at power- 
up). To select a notation type, use the ^&v escape sequence used above: 

^&v <n> <parameter> 

where: 

<n> is 0 (for RGB) or 1 (for HSL), 

<parameter> is a single character that specifies the action. 

To select a notation, the necessary <parameter> is M. Thus, the sequence 
^&v IM 

selects HSL notation. It does nothing more. 
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To specify the quantity of red (hue), green (saturation), and blue (luminosity) to appear in 
your background and foreground colors, the a, b, c, x, y, and z parameters are used. These 
parameters have the following meanings: 

a specifies red (hue) used in the foreground, 
b specifies green (saturation) used in the foreground, 
c specifies blue (luminosity) used in the foreground. 

X specifies red (hue) used in the background, 
y specifies green (saturation) used in the background, 
z specifies blue (luminosity) used in the background. 

Each a, b, c, x, y, and z parameter specified is preceded by a number in the range 0 through 1, 
in increments of 0.01. The following table gives the values needed to define the eight principle 
colors: 


Sample RGB/HSL Color Definition Values 


R 

G 

B 

Color 

H 

S 

L 

0 

0 

0 

Black 

X 

X 

0 

0 

0 

1 

Blue 

.66 

1 

1 

0 

1 

0 

Green 

.33 

1 

1 

0 

1 

1 

Cyan 

.5 

1 

1 

1 

0 

0 

Red 

1 

1 

1 

1 

0 

1 

Magenta 

.83 

1 

1 

1 

1 

0 

Yellow 

.16 

1 

1 

1 

1 

1 

White 

X 

0 

1 


X = don’t care (may be any value between 0 and 1) 
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The following tables provide algorithms for explicitly defining the ranges of the parameters 
mentioned in the previous table for a computer with color video. 


HSL Definition Algorithm 


COLOR SELECTED 

parm. 1 

H RANGE 

parm. 2 

S RANGE 

parm. 3 

L RANGE 

BLACK 

don’t care 

don’t care 

< 0.25 

WHITE 

don’t care 

<0.25 

>= 0.25 

RED 

.00- ,08 

>= 0.25 

> = 0.25 

YELLOW 

.09- .24 

>= 0.25 

>= 0.25 

GREEN 

.25- .41 

>= 0.25 

>= 0.25 

CYAN 

.42- .58 

>= 0.25 

>= 0.25 

BLUE 

.59- .74 

>= 0.25 

>= 0.25 

MAGENTA 

.75- .91 

>= 0.25 

>= 0.25 

RED 

.92-1.00 

>= 0.25 

>= 0.25 


In the RGB color method, when N represents the largest-valued (most intense) color of the three 
color specifications, colors are selected as follows: 


RGB Definition Algorithm 


COLOR SELECTED 

parm.1 

RED RANGE 

parm. 2 

GREEN RANGE 

parm. 3 

BLUE RANGE 

BLACK 

<.25 or <N/2 

<.25 or <N/2 

<.25 or <N/2 

WHITE 

>= .25 and > = N/2 

>=.25 and >=N/2 

> = .25 and > = N/2 

YELLOW 

> = .25 and > = N/2 

> = .25 and >=N/2 

<.25 or <N/2 

GREEN 

< 25 or <N/2 

> = .25 and > = N/2 

< .25 or <N/2 

CYAN 

<.25 or <N/2 

> = .25 and >=N/2 

>= .25 and > = N/2 

BLUE 

<.25 or <N/2 

< .25 or < N/2 

> = .25 and > = N/2 

MAGENTA 

>=.25 and > = N/2 

<.25 or <N/2 

> = .25 and > = N/2 

RED 

> = .25 and > = N/2 

<.25 or <N/2 

<.25 or <N/2 


One final parameter, i, is needed. It is used to assign a pen number to the newly-defined color 
pair. Thus, the escape sequence for changing a color pair definition is: 


^&v <0|l>m <n>a <n>b <n>c <n>x <n>y <n>z <pen#>I 
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where either a 0 or a 1 precedes the m parameter (selecting either RGB or HSL notation, 
respectively), and n is one of the legal values from the tables. <pen#> is an integer in the 
range 0 thru 7 which, precedes the i parameter, defines that pen number to be the color pair 
specified by the preceding a, b, c, x, y, and z parameters. Omitting any a, b, c, x, y, or z 
parameter causes a value of 0 to be assigned to the omitted parameter by default. 

Examples 

^&v Om la Ob Oc Ox ly Oz 51 

This example re-defines pen 5 to specify red characters on a green background. (Note that Model 
236 computers ignore the green background specification and assign a black one instead.) This 
example is equivalent to 

^&v Om la ly 51 

since omitted parameters (a, b, c, x, y, z) are given default values of 0. 

^&v Im .66a lb Ic 3i Om Ic lx ly 61 

This example re-defines pen 3 to specify blue characters on a black background (HSL notation), 
and pen 6 to specify blue characters on a yellow background (RGB notation). This example 
illustrates how multiple pens can be defined on a single line using different notations. (Again, 
note that the Model 236 will reject the background specification of pen 6, and will use black 
instead.) 

If you should specify color on color when setting up color definitions on the Model 236 computer 
with color video, you will find that the foreground color will remain as chosen and the background 
color will default to black. 

51 

This example re-defines pen 5 to specify a black foreground and a black background, using the 
previous notation type. 


NOTE 

Supplying neither a foreground nor a background color when defining a 
color pair causes both the foreground and background to be black. 
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Configuring the ITE 

The Internal Terminal Emulator is designed so that the various ITE characteristics can be con¬ 
figured quickly by displaying configure “menus” on the screen and then using system function 
keys to change the content of these menus. 

Configuration Function Keys 

To gain access to the configuration menus through the keyboard, press the function key I k9 I 
(labeled AIDS on the system console overlay). This causes the following softkey display to appear 
at the bottom of the screen: 



The function keys | f2 | (tab/mrgn), | f4 | (modes) and pf^ (FlexDisc) were covered in the section 
“Using the Keyboard” along with a brief discussion on the function key | f8 | (config). When you 
press 0^ (config) a new softkey display appears at the bottom of your screen. 



Pressing (terminal) fills the display with the Terminal Configuration Menu which is covered 
next. 
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Terminal Configuration Menu 

After pressing Qs] (terminal) your display should look like this; 


^TERMINAL CONFIGURATION 



Language USASCII 
ReturnDef Cr 


LocalEcho OFF 
XmitFnctn(A) NO 


CapsLock OFF 


Ascii 8 Bit NO 


InhEolWrp(C) NO 






Description of Fields 

The TERMINAL CONFIGURATION menu contains a set of unprotected fields that you access 
using the | TAB | key. Note that all fields can be changed using function keys Qf] (NEXT) and 
11^ (PREVIOUS) with the exception of ReturnDef which is changed using the function key RTI 
(DSPY FN). 

There are seven fields which can be changed using the function keys as defined in the next 
section. These fields are described as follows: 


ReturnDef specifies the definition of the | ENTER | key (labeled RETURN key on the 

overlay). The default definition is an ASCII <Si>. The definition may 
consist of up to two characters. If the second character is a space, it is 
ignored and only the first character is used. 

Default: <Si> space 

LocalEcho specifies whether characters entered through the keyboard are both dis¬ 

played on the screen and transmitted to the host computer. 

LocalEcho is enabled using this escape sequence: 

^&klL 

When this field is enabled characters entered through the keyboard are 
both displayed on the screen and transmitted to the host computer. The 
default condition for LocalEcho is disabled or OFF, because HP-UX will 
echo the character’s itself. The following escape sequence disables Lo¬ 
calEcho: 

^&kOL 
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CapsLock 


XmitFnctn(A) 


determines whether the ITE generates the full 128-characters ASCII set or 
only Teletype-compatible codes. The following escape sequence enables 
(turns ON) LocalEcho: 

^&klC 

When CapsLock is enabled the ITE generates only Teletype- 
compatible codes: uppercase ASCII (00-5F, hex) and DEL (7F, hex). Un¬ 
shifted alphabetic keys (a-z) generate the codes for their uppercase equiva¬ 
lents. The {, |, and } keys generate the codes for [, \, and ] respectively. 
The key for generating ~ and ‘ is disabled. 

The following escape sequence disables (turns OFF) CapsLock: 

^&kOC 

When CapsLock is disabled the ITE generates the full 128-character ASCII 
set of codes. Note that the default condition for CapsLock is disabled or 
OFF. 

determines whether escape code functions are executed at the ITE and 
transmitted to the host computer. The following escape sequence enters 
YES in the XmitFnctn field: 

^C&slA 

The escape code sequences generated by control keys such as | f | and | ^ | 
are transmitted to the host computer. If LocalEcho is ON, the function is 
also performed locally. 

The following escape sequence enters NO in the XmitFnctn field: 

^&sOA 

When NO is enter in this field the escape code sequences for the ma¬ 
jor function keys are executed locally but NOT transmitted to the host 
computer. 

Note that display functions will emit ^ Z and ^ Y to a host computer. 

The default condition for this field is NO. 
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InhEolWrp(C) designates whether or not the end-of-line wrap is inhibited. The following 
escape sequence enters NO in the InhEolWrp(C) field: 

^&sOC 

With NO in the InhEolWrp(C) field, when the cursor reaches the right 
margin it automatically moves to the left margin in the next lower line (a 
local carriage return and line feed are generated). 

The following escape sequence enters YES in the InhEolWrp(C) field: 

^&slC 

With YES in the InhEolWrp(C) field, when the cursor reaches the right 
margin it remains in that screen column until an explicit carriage return 
or other cursor movement function is performed (succeeding characters 
overwrite the existing character in that screen column). 

The default condition for this field is NO. 

Language changes the character set on your keyboard to one of the following when 

you press function key or [W\ : 

USASCII (United States) 

SVENSK/SUOMI (Swedish/Finnish) 

FRANCAIS azM (French AZERTY^ layout with mutes) 

FRANCAIS qwM (French QWERTY layout with mutes) 

FRANCAIS az (French AZERTY^ layout) 

FRANCAIS qw (French QWERTY layout) 

DEUTSCH (German) 

ESPANOL M (Spanish with mutes) 

ESPANOL (Spanish) 

KATAKANA (Japanese) 

The system console overlay works the same on all the keyboards listed. 
Diagrams of the previously mentioned keyboards can be found at the end 
of this article. 


The AZERTY characters can be obtained only through a software configuration of the keyboard. Physical AZERTY keyboards or hardware 
are not available on Series 200 computers except on the Models 217 and 237 which use the HP 46020A keyboard described in the 
article, “The Series 300 ITE as System Console” found in the manual, HP-UX Concepts and Tutorials Vol. 7. 
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Series 200 computers support three character sets which contain the spe¬ 
cial characters associated with all of the international languages. These 
character sets are: Extended Roman, Roman 8 and US/KATAKANA. 

The HP 98204A video interface board does not provide the Roman 8 
character set. This interface board provides the Extended Roman and 
the US/KATAKANA Character sets. The only difference between the 
Extended Roman and Roman 8 character sets are six additional characters 
included with the Roman 8 character set. These characters have been 
shaded in on the Roman 8 character set chart provided in this section. 

To get the Roman 8 character set you must have an HP 98204B video 
interface board with its CHAR SELECT switch set to the 1 or ON position. 
If on this same board you want the KATAKANA character set, you need 
to set the CHAR SELECT switch to the 0 or the OFF position. Note that 
there is no CHAR SELECT switch on the HP 98204A board. 

The following charts show the character sets previously mentioned. The 
8-bit code can be accessed by configuring the field ASCII 8 Bit to YES. 


NOTE 

Several languages are available for both the HP 98203A and 
HP 46020B keyboards. The default ITE language is determined by the 
language of the keyboard. 
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ROMANS CHARACTER SET 

(USASCII PLUS ROMAN EXTENSION) 
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Roman 8 Character Set 

To use the Roman 8 or Extended Roman Character Set, configure your 
TERMINAL CONFIGURATION menu to the language you want, ASCII 8 
Bit should be set to YES and your terminal (ITE) should be in the remote 
mode. Note that your terminal does not necessarily have to have REMOTE 
enabled, but if it is not, then the HP-UX environment must be set up to 
handle 8-bit characters. All characters for the various languages mentioned 
in the menu are now available to you except KATAKANA. 
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KANA8 CHARACTER SET 

(JISCII PLUS KATAKANA) 
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US/KATAKANA Character Set 


To use the US/KATAKANA Character Set, configure your TERMINAL 
CONFIGURATION menu to the language KATAKANA, ASCII 8 Bit should 
be set to YES and your terminal (ITE) should be in the remote mode. 
To type US characters, press | CTRL | - [T]* If you want KATAKANA 
characters, press | CTRL | - [T]. 
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For the French keyboard layouts, the AZERTY^ and QWERTY designa¬ 
tions refer to the location of the A, Z, Q, and W keys as follows: 


AZERTY: 

Row 3 = AZERTY 
Row 2 = Q S D (etc.) 
Row 1 = W X C (etc.) 

QWERTY: 

Row3 = QWERTY 
Row 2 = A S D 

Row 1 = Z X C (etc.) 


For the French and Spanish keyboard layouts, the mutes designation refers 
to the manner in which certain accent character keystrokes are handled f 
and ’ on the French layout and ’ on the Spanish). If the mutes are enabled, 
those keystrokes will NOT move the cursor or generate a character. If 
you then type an applicable vowel, the vowel will appear in the same 
character position with the accent and the cursor then will move to the 
next column. If you type any character other than an applicable vowel 
or a space, however, the character will be displayed and the accent key 
ignored. If you type a space after a mute accent, the accent alone will 
appear in that space. 

ASCII 8 Bit transmits from full set of 8-bit codes when enabled (YES) and transmits 
only codes less than 128 when disabled (NO). 

Values: YES (%&k II) = 8-bit codes. 

NO (^&k 01) = Standard 7-bit codes. 


Changing the Fields 

To change the fields in the Terminal Configuration Menu, press the | TAB | key until the cursor is 
located under the field you wish to change. Next, use the following function keys to change the 
state of the field. 

SAVE CFG saves the fields on the configuration menu which you have altered. 

NEXT changes the setting of the field you are presently in to the next setting in that 

field. For example, if US ASCI I is displayed in the Language field, pressing NEXT 
or would change the field to VLAAMS. 


The AZERTY characters can be obtained only through a software configuration of the keyboard. Physical AZERTY keyboards or hardware 
are not available on Series 200 computers except on the Models 217 and 237 which use the HP 46020A keyboard described in the 
article, “The Series 300 ITE as System Console” found in the manual, HP-UX Concepts and Tutorials Vol. 7. 
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PREVIOUS changes the setting of the field you are presently in to the previous setting in 
that field. For example, with FRANCAIS qzM displayed in the Language field, 
pressing PREVIOUS or would change the field back to US ASCI I. 

DEFAULT causes the fields in the menu to be filled with their default value. The default 
values are as shown in the TERMINAL CONFIGURATION display at the begin¬ 
ning of this section. The only exception is the Language field which defaults to 
the language option shipped with your system. 

DSPY FN enables and disables the display functions mode. Pressing the key once enables 
the display functions mode and pressing it a second time enables it. When en¬ 
abled, * appears in the function key label box. You use the display function mode 
for entering ASCII control characters in the ReturnDef field. Note that this im¬ 
plementation of display function is separate from that which is enabled/disabled 
via the mode selection keys. Enabling or disabling display functions mode us¬ 
ing this function key does NOT alter the effect of the DISPLAY FCTNS mode 
selection key (and vice versa). 


config removes the menu from the screen and changes the function key labels to the 
following: 
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ITE Escape Sequences 

Several Internal Terminal Emulator (ITE) keyboard functions can be activated or controlled by 
HP-UX through use of escape sequences. The effect is identical to using non-ASCII keys on the 
ITE keyboard. Escape sequences consist of the escape character followed by one or more visible 
(non-control) ASCII characters. 

The sequences listed in this section are recognized and executed by the ITE whether they are 
received from the data communication link or from the keyboard (in remote mode), although 
the keyboard is seldom used for escape sequences. If an illegal or unrecognized sequence 
is received, the ITE ignores the message and all subsequent data until one of the following 
characters is received: @, A thru Z, [, \, _, carriage-return (^), escape (^) or any ASCII 7-bit 

code less than the character space. 

Sequence Types 

There are two general categories of escape sequences. The two-character ITE control sequences 
are used primarily for ITE, screen, and cursor control. Most of these sequences are equivalent 
to keyboard operations that involve a single keystroke or the simultaneous pressing of two keys. 

The extended escape sequences consist of the escape-code character followed by at least two 
subsequent characters. They are used, either for functions that are not included in the two- 
character sequences, or for sequences whose inherent complexity requires two or more characters 
in addition to the escape character in order to define the operation. Absolute and relative cursor 
addressing are examples of operations that require longer control sequences. 
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Escape Sequences for ITE Control 


Escape 

Code 

Function 


Set tab 


Clear tab 

^3 

Clear all tabs 

^4 

NOT IMPLEMENTED (Set left margin) 

^5 

NOT IMPLEMENTED (Set right margin) 

^9 

NOT IMPLEMENTED (Clear all margins) 

^0 

NOT IMPLEMENTED (Makes the terminal program wait approximately 
one second.) 


Cursor up 


Cursor down 


Cursor right 


Cursor left 


Hard reset (power on reset of ITE) 


Cursor home down 


Move cursor to the left margin 


Cursor home up 


Horizontal tab 


Clear screen from cursor to the end of memory. 


Clear line from cursor to end of line 


Insert line 


Delete line 

V 

Delete character 


Start insert character mode 


End insert character mode 


Roll up 


Roll down 


Next page 


Previous page 


The Series 200 ITE as System Console 47 









Escape Sequences for ITE Control (continued) 


Escape 

Code 

Function 

*cw 

NOT IMPLEMENTED (Format mode on) 


NOT IMPLEMENTED (Format mode off) 


Enables display functions mode 


Disables display functions mode 


NOT IMPLEMENTED (Start unprotected field) 


NOT IMPLEMENTED (End unprotected/transmit-only field) 


NOT IMPLEMENTED (Primary terminal status request) 


Sense cursor position(relative) 


Sense cursor position (absolute) 

*tb 

NOT IMPLEMENTED (Unlock keyboard) 


NOT IMPLEMENTED (Lock keyboard) 


NOT IMPLEMENTED (Transmit a block of text to computer) 


NOT IMPLEMENTED (Modem disconnect) 


Soft reset (of ITE) 


Cursor home up. 


Back tab 


NOT IMPLEMENTED (Begin User Key Definition mode) 


NOT IMPLEMENTED (End User Keys Definition mode) 

^1 

NOT IMPLEMENTED (Begin Memory Lock mode) 


NOT IMPLEMENTED (End Memory Lock Mode) 


Default value for softkey f1 


Default value for softkey f2 


Default value for softkey f3 


Default value for softkey f4 

'tt 

Default value for softkey f5 


Default value for softkey f6 


Default value for softkey f7 


Default value for softkey f8 


NOT IMPLEMENTED (Initiate terminal self test) 


NOT IMPLEMENTED (Secondary terminal status request) 
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Extended Escape Sequences 


Escape Code 
Sequence 

Function 

^&a <col>c <row>Y 

Moves the cursor to column “col” and screen row “row” on 
the screen (screen relative addressing). The row or column 
values may be used by themselves in this escape sequence 
(e.g ^&a <col> C or ^&a <row> Y). The value you choose 
to leave out remains as previously set. 

^&a <col>c <row>R 

Moves the cursor to column “col” and row “row” in memory 
(absolute addressing). The row or column values may be used 
by themselves in this escape sequence (e.g ^&a <col> C or 
^&a <row> R). The value you choose to leave out remains 
as previously set. 

±<col>c ±<row>Y 

Moves the cursor to column “col” and row “row” (on the 
screen) relative to its present position (“col” and “row” are 
signed integers). A positive number indicates right or down¬ 
ward movement and a negative number indicates left or up¬ 
ward movement. The row or column values may be used by 
themselves in this escape sequence (e.g ^&a ib<col> C or 
^&a zb<row> Y). The value you choose to leave out remains 
as previously set. 

^&a ±<col>c ±<row>R 

Moves the cursor to column “col” and row “row” (on the 
screen) relative to its present position (“col” and “row” are 
signed integers). A positive number indicates right or down¬ 
ward movement and a negative number indicates left or up¬ 
ward movement. The row or column values may be used by 
themselves in this escape sequence (e.g ^&a di<col> C or 
^&a dz<row> R). The value you choose to leave out remains 
as previously set. 

*^C&qOL 

NOT IMPLEMENTED (Unlock configuration) 

^&qlL 

NOT IMPLEMENTED (Lock configuration) 

'ic&d 

<char> Selects the display enhancement indicated by 
<char> to begin at the present cursor position. <char> 
can be 0 or A thru 0. 
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Extended Escape Sequences (continued) 


Escape Code 


Sequence 

Function 

^&k<x>A 

AUTO LF enable: x=l; disable: x=0 

^&k<x>B 

NOT IMPLEMENTED (BLOCK enable: x=l; disable: x=0) 

^&k<x>C 

Caps Lock enable: x=l; disable: x=0 

^i:k<x>I 

ASCII 8 Bits enable: x=l; disable: x=0 

^&k<x>J 

NOT IMPLEMENTED (FrameRate 50 Hz : x=l; 60 Hz : x=0) 

^&k<x>L 

LocalEcho enable: x=l; disable: x=0 

^&k<x>M 

NOT IMPLEMENTED (MODIFY ALL enable: x=l; disable: 
x=0) 

^&k<x>N 

NOT IMPLEMENTED (SPOWLatch enable: x=l; disable: 
x=0) 

^&k<x>P 

Caps Mode is primarily used as a typing convenience and 
affects only the 26 alphabetic keys. When it is enabled, all 
unshifted alphabetic keys generate uppercase letters and all 
shifted alphabetic keys generate lowercase letters. 


enable: x=l; disable: x=0 

^&k<x>R 

REMOTE enable: x=l; disable: x=0 

^&s<x>A 

xmitFnctn(A) enable: x=l; disable: x=0 

^&s<x>B 

NOT IMPLEMENTED (SPOW(B) enable: x=l; disable: x=0) 

^&s<x>C 

InhEolWrp(C) enable: x=l; disable: x=0 

^i!S<X>D 

NOT IMPLEMENTED {Line/Page(D) enable: x=l; disable: 
x=0) 

^&s<x>G 

NOT IMPLEMENTED (InfHndShk(G) enable: x=l; disable: 
x=0) 

®iciEs<x>H 

NOT IMPLEMENTED (Inh DC2(H) enable: x=l; disable: 
x=0) 

^&w 12F 

Turns on the display window (top 24 rows) 

^&w 13F 

Turns off the display window 
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Extended Escape Sequences (continued) 


Escape Code 
Sequence 

Function 

^*d <parameters> 

List of <parameters> for display control: 

E Turns on alphanumeric display; 

F Turns off alphanumeric display. 

When terminating a string of escape sequences with these 
parameters use a capital letter. 

s <parameter> " 

Read device I.D. Status is parameter number 1. 

<x> 

Enables and disables the function keys (fl thru f8). If x equals: 

A Display the Modes set of function key labels, 

B Enable the User function keys. (The user key labels are 
displayed.) 

(a) Remove the function key labels from the screen. The User 
function keys, however, are still active. 

< attribute > a <key>k 

Defines the function keys. Information on how this is done 
can be found in the function key group section of this manual 
under the definition of user keys. 

^&v n< parameter > 

Read the section in this article “Accessing Color”. 


If an escape sequence is not recognized, the terminal ignores subsequent characters until ASCII 
decimal characters 0 thru 31 or 64 thru 95 is received, terminating the sequence. Note that ^ 
will terminate the old sequence and start a new one. 
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Keyboard Diagrams for Other Languages 

This section shows diagrams of the types of HP 98203B keyboards which are available to the 
Series 200 user. The keyboard option you now have can be configured to any of the languages 
by use of the TERMINAL CONFIGURATION menu previously mentioned in this article. 

To change to another keyboard language, use the terminal configuration menu and select the 
Language field you want. Then change the ASCII 8 Bit field to YES. Next, save the changed 
configuration menu. Note that the languages accessed through the terminal configuration menu 
are not available in the ui editor. The ui editor only uses the first 128 ASCII characters of your 
systems particular character set. For more information on your keyboard, read the appropriate 
manual sent with your system. 

You will notice as you look at the keyboards that a majority of the character key and numeric 
key labels have changed. To use your keyboard effectively in anyone of these languages, you 
will have to re-label the key caps or purchase a keyboard appropriate to the language you are 
using. 

HP 98203B Keyboards 



SVENSK/SUOMI (Swedish/Finnish) 
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FRANCAIS azM (French AZERTY^ layout with mutes is not available) 



FRANCAIS qwM (French QWERTY layout with mutes) 


^ The AZERTY characters can be obtained only through a software configuration of the keyboard. Physical AZERTY keyboards or hardware 
are not available on Series 200 computers except on the Models 217 and 237 which use the HP46020A keyboard described in the 
article, “The Series 300 ITE as System Console” found in the manual, HP-UX Concepts and Tutorials Vol. 7. 
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FRANCAIS az (French AZERTY® layout is not available) 



FRANCAIS qw (French QWERTY layout) 


^ The AZERTY characters can be obtained only through a software configuration of the keyboard. Physical AZERTY keyboards or hardware 
are not available on Series 200 computers except on the Models 217 and 237 which use the HP 46020A keyboard described in the 
article, “The Series 300 ITE as System Console” found in the manual, HP-UX Concepts and Tutorials Vol. 7. 
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ESPANOL M (Spanish with mutes) 
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ESPANOL (Spanish) 



KATAKANA (Japanese) 
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The Series 300 ITE 
as System Console 


Overview of Article 

This article provides you with a description of the ITE as system console for Series 300 com¬ 
puters. If you have a Series 200 computer and you are using it as a terminal connected to an 
HP-UX system, you need to read the “Terminal Emulator Manual” for the particular terminal 
your computer is to emulate. 

The topics this article covers are as follows: 

• Description of the ITE 

• Using the Keyboard 

• The Display 

• ITE Configuration 

• ITE Escape Sequences 
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Description of the ITE 

The Internal Terminal Emulator (ITE) consist of “device driver” code contained in the HP-UX 
kernel and associated with the keyboard and monitor on a Series 300 computer. Your particular 
keyboard and monitor combination are considered to be an ITE if they meet one requirement 
given in the section, “Keyboard Requirements” and one requirement given in the section, “Mon¬ 
itor Requirements”. 


Keyboard Requirements 

The keyboard you are using is considered to be an ITE keyboard if it is an HP 46020A (HP-HIL 
Keyboard) connected to the computer mainframe’s HP-HIL interface port. 

Monitor Requirements 

The monitor you are using is considered to be an ITE monitor if it is an: 

• HP35721A/B/C or HP35731A/B monitor connected to a built-in Model 310 video 
board, 

• HP 98782 and 98700H monitor connected to an HP 98287A video board which has been 
configured for “internal” control space, 

• HP 3573 lA/B monitor connected to an HP 98542 or HP 98546 video board, 

• HP 35741A/B monitor connected to an HP 98543 or HP 98546 video board, 

• HP 98781A monitor connected to an HP 98544 video board, 

• HP98782A monitor connected to an HP 98545 video board. 
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Description of a System Console 

The system console is a keyboard and monitor (or terminal) given a unique status by HP-UX 
and associated with the special (device) file /dev/console. All boot ROM error messages, HP-UX 
system error messages, and certain system status messages are sent to the system console. 
Under certain conditions (for example, the single-user state), the system console provides the 
only mechanism for communicating with HP-UX. 

The boot ROM and HP-UX operating system assign the system console function according to a 
prioritized search sequence. HP-UX’s search for a system console terminates as soon as one of 
the following conditions is met: 

• A built-in serial interface, HP 98626A, HP98628A\ HP 98642A, or HP 98644A RS- 
232C serial interface is present with the “remote bit”^ set. If more than one serial 
interface card with its “remote bit” set is present, the one with the lowest select code is 
used. In the case of the HP 98642A (4-channel multiplexer), port 1 is used. 

• An “internal” bit-mapped display is present. This is true if a Model 310 built-in video 
output, HP 98542A, HP 98543A, HP 98544A or HP 98545A board is present. It is 
also true if an HP98700H display station with its display interface card (HP98287A) 
configured for “internal” control space is present. Note that if the HP 98700H display 
station’s display interface card (HP 98287A) is configured for “external” control, it is never 
chosen (“external” bit-mapped displays have a specific select code address and “internal” 
bit-mapped displays do not). 

• An HP 98546A compatibility video interface is present. 

• A built-in serial interface, HP 98626A, HP 98628A, HP 98642A, or HP 98644A RS-232C 
serial interface is present without the “remote bit” set. If more than one is present, the one 
with the lowest select code is used. In the case of the HP 98642A (4-channel multiplexer), 
port 1 is used. The boot ROM docs not recognize the serial interface card as console 
when this condition is met; however, HP-UX does. 

If none of the above conditions are met, no system console exists. While boot ROM tolerates 
this, HP-UX will not. 


The HP 98628A Datacomm Interface Card with its “remote bit” set is not supported as a remote console by the Revision A boot ROM; 
however, it is supported as the system console by the HP-UX operating system. Therefore, when an HP 98628A card is used and has its 
“remote bit” set, the boot ROM sends messages to the next console found, but HP-UX sends its messages to the ITE (terminal) associated 
with the HP 98628A card. 

On the HP 98626A Serial Interface board the remote bit is set by cutting a jumper as described in the installation manual supplied with 
your computer. On the HP 98628A, HP 98642A and HP 98646A interface cards the remote bit is set by setting a switch on the board 
as described in each board’s installation manual. 
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Additional Considerations 

This section contains information on bit settings for the HP 98626A RS-232C Serial Interface 
Card’s Line Control Switch Pack. 

The boot ROM requires that the Line Control Switch Pack settings on the HP 98626A RS-232C 
Serial Interface card be set to the same setting as your remote terminal. HP-UX resets these 
values to system defaults on log in. These values are as follows: 


Stop Bits 

should be set to 1. 

BaudRate 

should be set to 9600 bps. 

Parity/DataBits 

should be set to O’s/7. 

Enq/Ack 

should be set to NO. 

Pace 

(Handshake) 

should be set to XON/XOFF. 


To make the above settings on your HP 98626A Serial Interface card, set your cards Line 
Control Switch Pack (U-2) switches as follows: 


Bit 0 

Bit 1 

Bit 2 

Bit 3 

Bit 4 

Bit 5 

Bit 6 

Bit 7 

1 

1 

0 

0 

1 

0 

1 

0 


Additional settings for Handshake Type bits 6 and 7 of the Line Control Switch Pack are: 


Bit 6 


Handshake Type 

0 

0 

ENQ/ACK 

1 

0 

XON/XOFF 

0 

1 

NO HANDSHAKE 

1 

1 

NO HANDSHAKE 


Note that the other switch settings for the Line Control Switch Pack on the HP 98626A card 
are defined in the installation manual supplied with that card. 
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Using the Keyboard 

This section of the article covers the Series 300 ITE System Console keyboard. This keyboard 
is divided into five functional groups: 

• Character Entry Group, 
e Numeric Group, 

• Display Control Group, 
e Edit Group, 

e Function Key Group, 

• System Control Group. 

The remainder of this section covers these key groups using the HP 46020A keyboard. 
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HP 46020A Keyboard 
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Character Entry Group 

The character entry keys are arranged like a typewriter, but have some added features. This 
is the largest group on the keyboard, comprising 60 keys capable of generating 96 characters; 
including upper and lower-case alphabetic characters, numeric characters, space, punctuation, 
and some commercial symbols. Several data control keys are also available. The character 
indicated on the bottom-half of the keycap is the standard (or base) character generated by the 
key. The character indicated on the top-half of the keycap is the shifted character. 


I Shift I gives you uppercase letters when you are typing in lowercase (caps lock 

off). When you are typing in uppercase (caps lock on) , this key will give 
you lowercase letters. 

I Caps I sets the unshifted keyboard to either uppercase (the power-on default) or 

lowercase (normal typewriter operation) letters. 

I Return | sends the ReturnDef sequence to the computer (the default is to send Si). 

When a program is running, this key is used to input information requested 
by the computer. 

I Tab I sends a tab character (CTRL-I) to the computer. 

I CTRL I provides access to the standard ASCII control characters. 


I Back space | sends the back space character (CTRL-H) to the computer in the remote 
mode, and in the local mode it moves the cursor one space to the left. 

I DEL I generates the Escape control character. This key pressed on its own equals 

I ESC I I ESC | . The escape character (followed by one or more alphanumeric char¬ 

acters) initiates terminal controls similar to those normally available to the 
computer; see the section of this article, “ITE Escape Sequences”. For 
example, to home up the cursor (left margin of first line), press | ESC | and 
the capital | H | . 

I DEL I is used to generate the Delete character. This key is pressed when 
I Shift I is pressed to obtain the Delete character. In Local Mode, this charac¬ 
ter is displayed as an inverse video square. In Remote Mode, the displayed 
character and its use depends on the application program. 

I Print I is not implemented on ITEs. 

The I Enter | key is not implemented on ITEs. 

I Select I is not implemented on ITE’s. 
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I Extend char | pressed in conjunction with another key accesses the Roman 8 character 
set. The complete Roman 8 character set can be found in the section, 
“Configuring the ITE”. Your computer may not be able to display all of 
these characters; when the key for an undisplayable character is pressed, 
an hp or regular alphabetic character will appear on the screen in its place. 


To use the | Extend char | key for displaying Roman 8 and KATAKANA characters, you must 
configure the HP-UX environment on your ITE so that: 

• parity generation and detection are disabled, 

• the character size is 8 bits, 

• input characters are not stripped to seven bits. 

The terminal configuration menu must also have its ASCII 8 Bit field set to YES and the 
Language field set to KATAKANA for KATAKANA characters or any other language except 
KATAKANA for Roman 8 characters. If your ITE’s monitor is connected to an HP98546A 
video compatibility interface card, then you should make sure that the CHAR SELECT switch 
on that card is set to 1 for Roman 8 characters and 0 for KATAKANA characters. 

The following step-by-step procedure explains how to set up your ITE environment to deal with 
8-bit characters: 

1. Execute the following stfy(l) command to prevent input characters from being stripped to 
seven bits, to use 8-bit characters, and to disable parity checking. 

stty -parenb cs8 -istrip | Return | 

2. Enter the Terminal Configuration menu by pressing: 

a. I System | key, 

b. then function key (config), 

c. then function key (terminal). 

3. The cursor should be in the Language field and any language except KATAKANA should 
be displayed. If the language displayed is KATAKANA press the function key | f2 | (NEXT 
CHOICE) until the language you need appears in that field. 
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4. Tab to the ASCII 8 Bit field and press function key (NEXT CHOICE) until YES 
appears in that field. Next press function key Qj] (SAVE CONFIG). 

5. Return to the system mode by pressing the | System | key. 

Your terminal or computer is now configured for use with the | Extend chairl key. To use this 
key, simply hold it down and press the key associated with the Roman 8 character you wish 
to type. Note that this same key works with the KATAKANA characters if the Language field 
of your terminal configuration menu is set to KATAKANA instead of US ASCII. To enable the 
KATAKANA character set press the | Extend char | key to the right of the space bar once. With 
the KATAKANA character set enabled, any key you press will produce KATAKANA characters. 
To disable the KATAKANA character set, press the | Extend char | to the left of the space bar. 
Pressing this | Extend char | key enables the USASCII character set and any key you press will 
return a USASCII character. 

Refer to the figure “Diacritic Characters for the HP46020A”, and type the following charac¬ 
ter using the | Extend ch^ key (your terminal configuration menu’s Language field should be 
configured for USASCII characters): 

ae 

To do this hold down | Extend ch^ and press the unshifted | E | key. 

The I Extend char | key can also be use to access the diacritical marks shown in the diagram below. 
The terminal configuration menu should still have the Language field set to any non-KATAKANA 
language and the ASCII 8 Bit field set to YES. You should also be in the local mode. Note that 
even though you use two keystrokes to produce diacritical combinations only one byte (character) 
is sent to the computer. 



□ □□□ 


t.... i::, .- „ . ..^ 

. 

H[a|o|D[a[0|a[B[H|H|B|a[B|BMa^ 

QODD 

□ DOB 

□ DDD 
DDDFl 
p in 1 





Diacritic Characters for the HP 46020A 
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Some accented characters do not appear on a keycap but are formed by combining two char¬ 
acters; normally a diacritic mark plus an alphabetic character (e.g., a circumflex plus a vowel). 
The ITE handles these characters as follows: 

1. A character is typed that corresponds to the first part of a diacritical combination (for the 
configured keyboard type). The cursor will not move and no character will be displayed. 

2. The next character is typed: 

a. If it forms a valid character combination (one giving a valid diacritical combination) 
the combination is displayed and the cursor moves to the next character position. 

b. If it forms an invalid character combination (other than space), the previous keystroke 
is ignored and the most recently typed character is displayed. 

c. If it is a space, the first character is displayed on the screen, and the cursor moves 
to the next character position. 

Numeric Group 

The numeric group of keys is located to the right of the character keys. The layout of the 
numeric key pad is similar to that of a standard office calculator. These keys are convenient for 
high-speed entry of numeric data. Again note that the | Enter | key is not implemented on the 
ITE keyboard. 

Display Control Group 

The display control group consists of the keys that control the location of the cursor on the 
display. Each display control key and its function is described in the sections that follow. 

Setting and Clearing Tab Stops 

You can define and delete a series of tab stops by using the following tab function keys. 

SET TAB sets tab stops. 

CLR TAB deletes current tab stop. 

CLR TABS deletes all tab stops. 

These are function keys are Qg], Qs], and respectively. To obtain these system-defined keys, 
press the | System | key. One of the function key labels which appears at the bottom of the display 
is the tab/mrgn function key, Q^. Press this function key and you will receive a set of function 
key labels containing SET TAB, CLR TAB, and CLR TABS. 
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Cursor Control 

The arrow keys allow you to move the cursor horizontally and vertically on the display. These 
keys are enabled when you are in the vi editor; however, they are not recommended for use 
while in the vi editor^. 

nn moves the cursor up in the output area of the display screen. 

[Y] moves the cursor down in the output area of the display screen. 

moves the cursor to the left in the output area of the display screen, 
moves the cursor to the right in the output area of the display screen. 

While in the shell environment (not in the vi editor), these same keys used in conjunction with the 

I Shift I key enable you to scroll up and down through the screen display to the next or previous 

page. They also allow you to move the cursor to its upper or lower home position. These keys 
are listed as follows: 

shift- scrolls the screen display downward, 

shift- [X] scrolls the screen display upward. 

rv~] moves the cursor to its upper home position. 

shift-fXI moves the cursor to its lower home position. 

Another way to move to the next or previous page is to use the following keys: 

I Next I moves you forward a page within your text. 

I Prey | moves you back a page within your text. 

What is the next page or previous page? Data in display memory can be accessed (displayed on 
the screen) in blocks that are known as “pages”. A page consists of 24-lines (47-lines for a high 
resolution monitor) of data. The current page is that sequence of lines which appears on the 
screen at any given time. The previous page is the preceding 24 lines in display memory. The 
next page is the succeeding 24 lines in display memory. This concept, along with the concept 
of rolling data through the display screen and memory, are shown in the following illustrations. 


3 


On busy systems an escape character created by these keys can be lost and misinterpreted by the system. This may result in the loss of 
data on a given line. 
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Edit Group 

The edit group consists of the keys that allow you to modify the data presented on the screen. 
However, the edited data cannot be read back by the system. Typically these features are used 
to modify text within a program or file, to view data which has scrolled out of the screen window 
and to clear the screen. 


To use these features in the vi editor, you should have an .exrc file in your $HOME directory 
which maps these keys to their function using escape code sequences. Reference to this file is 
made in the HP-UX System Administrator Manual and in “The Vi Editor” selected article. 


All line edit keys and character edit keys function as stated below: 


I Clear line | 


I Insert line | 


I Delete line | 


I Insert charl 


I Delete char | 

I Clear display | 


clears the characters in a line from the present cursor position to 
the end of the line. 

causes the line containing the cursor and all text lines below it to 
move down one line, and a blank line to be inserted in the row 
containing the cursor. The cursor will move to the left margin of 
the blank line. 

deletes the line containing the cursor from display memory. All text 
lines below this line will roll up one row, and the cursor will move 
to the left margin. 

sets the insert mode, allowing you to insert characters to the left of 
the cursor. 

deletes the character at the current cursor location. 

clears all the display memory (and screen) from the current cursor 
position to the end of the memory. 
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Function Key Group 

On the upper part of your keyboard is a set of eight function keys. The functions performed 
by these keys change dynamically as you use the computer. At any given time the applicable 
function labels for these keys appear across the bottom of the display screen. This section of 
the article covers how these keys have been assigned by the system and how you can define 
them. The topics covered are: 

• Modes of Operation, 

• System-Defined Keys, 

• Defining User Keys Locally, 

• Defining User Keys Programmatically, 

• Controlling Function Key Labels Programmatically. 

Modes of Operation 

The HP 46020A keyboard has two modes of operation: system mode and user mode. The 
mode is set with the | System | / | User | key. 

The mode of operation for HP 46020A keyboards defines the functions of the keys QT] through 
I f8 I that run across the top of the keyboard. In the system mode for Internal Terminal Emulators 
(ITEs), these keys are given definitions by the HP-UX system. In user mode, the keys are given 
definitions that you (or some application program) provide. 


The HP 46020A keyboard is set to the modes function after the HP-UX system is booted. Note 
that anytime after boot up the modes function softkeys can be displayed by pressing the | System | 
key and then the ffTI (modes) function key. The softkeys associated with this function are as 
follows: 



The asterisk in the REMOTE softkey label shown above indicates that the function named is 
active. In order to use any terminal or computer keyboard with HP-UX you must have this 
softkey active as seen above. If the softkey is not active just press the the function key once 
and it will become active. 
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Definitions for the mode function keys are as follows: 

REMOTE when active, puts the terminal in communication with a computer. When 

the asterisks is absent from the label, the terminal operates in Local 
mode. Characters typed on an ITE in LOCAL mode are merely displayed 
and are not sent to any user process in HP-UX. 

DSPY FN when active, does the following: 

• In local mode, it displays control codes and escape sequences 
but does not execute them. For example, if you press the 

key the terminal displays on the screen but 
does not perform the “cursor left” function. 

• In remote mode, it transmits control codes and escape 
sequences but does not execute them locally. For example, 
it you press | Shift | and [T] (roll up) the terminal 
transmits an but does not perform the “roll up” 
function. If local echo is enabled (ON) then the 

is also displayed on the screen. 

There are two exceptions to the foregoing description: 

• When you press the DSPY FN function key, the 
(which disables display functions mode) or 

(which enables display functions mode) is executed but is 
not transmitted or displayed. 

• A Si (or if auto line feed mode is enabled) is 
transmitted, and (if echoed) it is executed and displayed 
and the ITE also performs a line feed. 

AUTO LF when active, causes a carriage-return (Si) linefeed (^) to be generated 

whenever you press | Return | key (instead of just Si). 

The definitions of the keys ffTI through ff^ can be removed or displayed along the bottom of the 
screen with the | Menu | key. The functions of the | System | , | User | and | Menu | keys are described 
below. 

I System | | System | turns on system mode, giving keys | f1 | through | f8 | (as shown 

below) their HP-UX system definitions (see the “System-defined Keys” 
section that follows). 
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The softkey labels shown above are what you see on the ITE. 


I User I I User | turns on the user mode, giving keys | f1 | through | f8 | definitions 

(shift- | System | ) provided by an application program (see the “User-defined Keys” section 

that follows). The | User | key is used in conjunction with the | Shift | key 
I to display the following softkeys: . 




I Menu I The actual definitions (labels) for the system-defined and user-defined 

keys can be removed or displayed at the bottom of the screen. | Menu | , 
I CTRL | — I Menu | , | System | and | User | (| Shift | — | System |) are used to control 
the display of these labels. | CTRL | — | Menu | calls up the users key display 
so you can define your softkeys QT] through pfSl . | User | (| Shift | — | System |) 
displays the user defined softkeys. | System | displays the System defined 
softkeys. | Menu | when toggled turns the softkey labels off and on. 


System-Defined Keys 

The system-defined keys are the definitions given to fTTI through pfSl while in system mode. 
Their actual labels are displayed on the screen when | System | is pressed. Refer to the tables at 
the back of this appendix for the labels supplied by your particular keyboard. 

tab/mrgn displays a set of labels that enable control of margins, tabs, and se¬ 

lection of the start column for data transmission to a host computer. 


modes 

FlexDisc 

config 


displays labels for controlling display operations, 
not implemented. 

displays a set of labels that allow the selection of the terminal configu¬ 
ration menu. 
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Defining User Keys Locally 

The user-defined keys are the definitions given to QT] through while in user mode. Their 
actual labels are displayed on the screen when | User | or | Shift H System | is pressed. 

As their name suggests, user-defined keys may be defined by you, the user, or by an application 
program you execute. 

When defining a key from the keyboard, the key content may include explicit escape sequences 
(entered using Display Functions mode) that control or modify the terminal operation. These 
escape sequences can be found in the section of this article entitled, “ITE Escape Sequences”. 

The definition of each user key may contain up to 80 characters (alphanumeric characters, ASCII 
control characters, and explicit escape sequence characters). 

To define User keys locally (from the keyboard), simultaneously press the | CTRL | — | Menu | keys. 
The following user keys menu will appear: 
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KEY 

DEFINITION 

FIELD 


ATTRIBUTE 

FIELD 


LABEL 

FIELD 



fl 

T 

Label 

fl 

f2 

T 

Label 

f2 

f3 

T 

Label 

f3 

f4 

"us 

T 

Label 

f4 

f5 

T 

Label 

f5 

f6 

V 

T 

Label 

f6 


T 

Label 

f7 

f8 

T 

Label 

f8 


NEXT I PREVIOUS I DEFAULT 







This menu contains the default values for all of the fields. If your screen does not contain the 
default values as shown and you want them set and displayed, press |l4] (DEFAULT). 

The menu contains a set of fields that you access using the | Tab | key. 

For each user key the menu contains three unprotected fields: 

ATTRIBUTE FIELD — This one character field always contains an uppercase L, T, or N 
signifying whether the content of the particular user key is to be: 

L Executed locally only. 

T Transmitted to the host computer only along with a trailing Si- 
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N Treated in the same manner as the alphanumeric keys. If the terminal or computer is 
in local mode, the content of the key is executed locally. If the terminal or computer 
is in the remote mode and LocalEcho is disabled (OFF), the content of the key is 
transmitted to the host computer. If the terminal or computer is in the remote mode 
and local echo is enabled (ON), the content of the key is both transmitted to the host 
computer and executed locally. 

Since the alphanumeric keys are disabled (ITE only) when the cursor is positioned in this field, 
you change the content of this field by pressing (NEXT) or (PREVIOUS). 

LABEL FIELD — This eight-character field to the right of the word “Label” allows you to supply 
the user key’s label. When the terminal is in user key’s mode, the key labels are displayed from 
left to right in ascending order across the bottom of the screen. 

KEY DEFINITION FIELD — The entire line (80 characters) immediately below the attribute 
and label field is available for specifying the character string that is to be displayed, executed, 
and/or transmitted whenever the particular key is physically pressed. 

When entering characters into the key definition field you may use the display functions mode. 
Note that this implementation of display functions mode is separate from that which is en¬ 
abled/disabled via the mode selection keys. When entering the label and key definition you may 
access display functions mode by way of function key \W\ , 

The I Return | key can be used to include carriage return (Si) codes (with display functions mode 
enabled) in key definitions. If auto line feed mode is also enabled, the | Return | key will generate 
a otherwise it is considered a cursor movement key. 

When the user keys menu is displayed on the screen you may use the | Insert ch^ , | Delete chaFI , 
I Clear linel and arrow keys for editing the contents of the label and key definition fields. 
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Defining User Keys Programmatically 

From a program executing in a host computer, you can define one or more keys using the 
following escape sequence format: 

<attribute><key><label length><string length><label><string> 

where: 

<attribute> = Oa : normal (N) (0 is the default) la : local only (L) 2a : transmit only (T) 
<key> = l-8k : fl-f8, (1 is the default) respectively 

<label length> = 0-16d (0 is the default and only the first 8 characters are displayed) <string 
length>= 0-80L (1 is the default) (-1 causes field to be erased) 

The <attribute>, <key>, <label length>, and <string length> parameters may appear in any 
sequence but must precede the label and key definition strings. You must use an uppercase 
identifier (A, K, D, or L) for the final parameter and a lowercase identifier (a, k, d, or 1) for 
all preceding parameters. Following the parameters, the first 0 through 16 characters, as 
designated by <label length>, constitute the key’s label; however, only the first 8 characters are 
recognized. The next 0 through 80 characters, as designated by <string length>, constitute the 
key’s definition string. The total number of displayable characters (alphanumeric data, ASCII 
control codes such as Si and Sf, and explicit escape sequence characters) in the label string must 
not exceed 16 (only the first 8 characters are displayed on the label), and in the definition string 
must not exceed 80. 

Example: Assign login as the label and TOM as the definition for the user key. This function 
key is to have attribute “N”. Note that Sl&jB is the escape sequence used in this example to 
turn on the user key labels. 

0a5k5d3LloginT0MS:& j B 

After issuing the foregoing escape sequence from your program to the terminal, the | f5 | portion 
of the user keys menu is as follows: 

f5 N LABEL login 
TOM 

If the transmit only attribute (2) is designated, the particular user key will have no effect unless 
the terminal is in remote. 
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Controlling the Function Key Labels Programmatically 

From a program executing in a host computer, you can control the the function key labels display 
as follows by using escape sequences: 

• You can remove the key labels from the screen entirely (this is the equivalent of toggling 
I Menu I) . 

• You can enable the mode selection keys (this is the equivalent of pressing the | System | key. 
Then pressing the softkey labeled modes). 

• You can enable the user keys (this is the equivalent of simultaneously pressing the | Shift | 
and I User | keys). 


The escape sequences are as follows: 


Removes all key labels from the screen. 

^&jA Enables the modes key. 

^&jB Enables the user keys. 

System Control Group 

These keys are located in the upper-left corner of your keyboard. They control system functions 
related to display operations. 


I Reset I I Reset | provides a SOFT RESET that does the following: 

• Sounds the computer’s beeper. 

• Disables display functions mode (if enabled). 

Note that the data on the display, all terminal operating modes 
(except display functions mode), and all active configuration pa¬ 
rameters are unchanged. 

Pressing the | Reset | key (SOFT RESET), is also good for restoring 
the the ITE after using the screen for graphics. 

The ITE can be returned to the power-on state by holding down 
the I Shift I and | CTRL | keys and pressing I Reset | . This is also called 
a HARD RESET. 
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I Shift H CTRL H Reset | 

(HARD RESET) 


I Break | 


I Stop I 


has the same effect as restarting the ITE. A HARD RESET does 
the following; 

• Sounds the computer’s beeper. 

• Clears all of alphanumeric memory. 

• Resets the terminal configuration menu parameters to 
their power on values. 

• Resets certain operating modes and parameters as 
follows: 

• Disables display functions mode, and caps mode. 

• Turns off the insert character edit function. 

• Resets the user keys to default values. 

• Turns on the alphanumeric display. 

• Resets color pairs to their default values 

I Break | creates an interrupt signal (SIGINT) which is sent to all 
processes within your process group. For information on this 
signal read the sections SIGNAL(2) and TTY(4) in your HP-UX 
Reference. To learn how to use this signal in a shell script read, 
“Bourne Shell Programming” found in your HP-UX Concepts and 
Tutorials, Vol. 4 and 5. 

I Stop I is the same as using | CTRL H S | to suspend the display and 
I CTRL H Q I to continue the display. Pressing the | Stop | key once 
suspends the display and pressing it again continues the display. 
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The Display 

The Internal Terminal Emulator’s (ITE’s) display has many features of its own, video highlights 
(such as inverse video), raster control, cursor sensing and addressing, and color highlight control 
(for Series 300 computers equipped with a color display). These functions are accessed only 
through escape sequences and are discussed in the sections that follow. As you read this 
section, note the last letter in an extended escape sequence is always capitalized. An extended 
escape sequence consists of the “escape” (ASCII character 27) character followed by at least 
two subsequent characters. 

Memory Addressing Scheme 

Display memory positions can be addressed using absolute or relative coordinate values. On a 
Series 300 Medium Resolution monitor, display memory is made up of 80 columns (0 thru 79) 
and up to four 24 line pages (100 lines of scrolling) with 80 characters per line. On Series 300 
High Resolution monitors, display memory is made up of 128 columns (0 thru 127) and up to 
two 47 line pages (100 lines of scrolling) with 128 characters per line. The types of addressing 
available are absolute (memory relative), screen relative, and cursor relative. 

Row Addressing 

The figure below illustrates the way that the three types of addressing affect row or line numbers. 
The cursor is shown positioned in the fourth row on the screen. Screen row 0 is currently at 
row 6 of display memory. In order to reposition the cursor to the first line of the screen the 
following three destination rows could be used: 


Absolute: row 6 

Screen Relative: row 0 
Cursor Relative: row -3 



a.) Absolute: row 6 b.) Screen Relative; row 0 c.) Cursor Relative: row-3 

Row Addressing 
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Column Addressing 

Column addressing is accomplished in a manner similar to row addressing. There is no difference 
between screen relative and absolute addressing. The figure below illustrates the difference 
between absolute and cursor relative addressing. The cursor is shown in column 5. 

Whenever the row or column addresses exceed those available, the largest possible value is 
substituted. In screen relative addressing, the cursor cannot be moved to a row position that is 
not currently displayed. For example, in the cursor relative portion of the figure above (showing 
row addressing), a relative row address of -10 would cause the cursor to be positioned at the top 
of the current screen (relative to row -3). Column positions are limited to the available screen 
positions. For example, in the following illustration, the absolute column addressing example 
shows limits of 0 and 79, while the relative column addressing example shows limits of -5 and 
+74. The cursor cannot be wrapped around from column 0 to column 79 by specifying large 
negative values for relative column positions. 


0 1 2 3 4 5 6 7 8 9 79 

-5 - 

4-3-2-10+1 +2+3 

i 'I 




■ 


I 

1 



_ 

7 

a.) Absolute and Screen Relative 

b )Cursor Relative 


Column Addressing 


Cursor Sensing 

The current position of the screen cursor can be sensed. The position returned can be the 
absolute position in the display memory or the location relative to the current screen position. 

Cursor sensing only functions when the “terminal” is in remote mode. 

Absolute Sensing 

When a program sends the escape sequence to the terminal, the terminal returns to the 
program an escape sequence of the form ^&axxxcyyyRSi, where xxx is the absolute column 
number and yyy is the absolute row number of the current cursor position. You will later see 
that this escape sequence is identical to the escape sequence for an absolute move of the cursor. 
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Relative Sensing 

When a program sends the escape sequence ^ ‘, the terminal returns to the program an escape 
sequence of the form ^&a xxxcyyyY^i where xxx is the column number of the cursor and yyy 
is row position of the cursor relative to screen row 0. This escape sequence is identical to the 
escape sequence for a relative move of the cursor (discussed later in this article). 

Cursor Positioning 

The cursor can be positioned directly by giving memory or screen coordinates, or by sending 
the escape codes for any of the keyboard cursor positioning operations. 

Screen Relative Addressing 

To move the cursor to any character position on the screen, use any of the following escape 
sequences: 

^&a<column number> c <row number>Y 
^&a<row number> y <column number>C 
^&a< column number >C 
^&a<row number>Y 
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where: 


< column number > is a decimal number specifying the screen column to which you wish 
to move the cursor. Zero specifies the leftmost column. 

<row number > is a decimal number specifying the screen row (0 thru 23) to which 

you wish to move the cursor. Zero specifies the top row of the 
screen; 23 specifies the bottom row. 

When using the escape sequences for screen relative addressing, the data on the screen is 
not affected (the cursor may only be moved around in the 24 rows and 80 columns currently 
displayed, thus data is not scrolled up or down). 

If you specify only <column number>, the cursor remains in the current row. Similarly, if you 
specify only <row number>, the cursor remains in the current column. 

Example 

The following escape sequence moves the cursor to the 20th column of the 7th row on the 
screen: 

^&a6yl9C 

Absolute Addressing 

You can specify the location of any character within display memory by supplying absolute 
row and column coordinates. To move the cursor to another character position using absolute 
addressing, use any of the following escape sequences: 

^&a<column number> c <row number>R 
^&a<row number> r <column number>C 
^&a<column number>C 
^&a<row number >R 


The Series 300 ITE as System Console 25 



where: 


< column number > is a decimal number (0 thru 79) specifying the column coordinate 

(within display memory) of the character at which you want the 
cursor positioned. Zero specifies the first (leftmost) column in display 
memory, 79 the rightmost column. 

<row number > is a decimal number (0-99) specifying the row coordinate (within 

display memory) of the character at which you want the cursor 
positioned. Zero specifies the first (top) row in display memory, 
max specifies the last. 

When using the above escape sequences, the data visible on the screen rolls up or down (if 
necessary) in order to position the cursor at the specified data character. The cursor and data 
movement occur as follows: 

• If a specified character position lies within the boundaries of the screen, the cursor moves 
to that position; the data on the screen does not move. 

• If the absolute row coordinate is less than that of the top line currently visible on the 
screen, the cursor moves to the specified column in the top row of the screen; the data 
then rolls down until the specified row appears in the top line of the screen. 

• If the absolute row coordinate exceeds that of the bottom line currently visible on the 
screen, the cursor moves to the specified column in the bottom row of the screen; the 
data then rolls up until the specified row appears in the bottom line of the screen. 

If you specify only a <column number>, the cursor remains in the current row. Similarly, if you 
specify only a <row number>, the cursor remains in the current column. 

Example 

To position the cursor (rolling the data if necessary) at the character residing in the 60th column 
of the 27th row in display memory, the escape sequence is: 

^&a26r59C 


26 The Series 300 ITE as System Console 



Cursor Relative Addressing 

You can specify the location of any character within display memory by supplying row and 
column coordinates that are relative to the current cursor position. To move the cursor to 
another character position using cursor relative addressing, use any of the following escape 
sequences: 

zb <column number> c zb <row number>R 
^&a zb <row number > r zb < column number >C 
^&a zb <column number>C 
zb <row number>R 

where: 

< column number > is a decimal number specifying the relative column to which you 
wish to move the cursor. A positive number specifies how many 
columns to the right you wish to move the cursor; a negative number 
specifies how many columns to the left. 

<row number > is a decimal number specifying the relative row to which you wish 

to move the cursor. A positive number specifies how many rows 
down you wish to move the cursor; a negative number specifies how 
many rows up you wish to move the cursor. 

When using the above escape sequences, the data visible on the screen rolls up or down (if 
necessary) in order to position the cursor at the specified data character. The cursor and data 
movement occur as follows: 

• If a specified character position lies within the boundaries of the screen, the cursor moves 
to that position; the data on the screen does not move. 

• If the specified cursor relative row precedes the top line currently visible on the screen, 
the cursor moves to the specified column in the top row of the screen; the data then rolls 
down until the specified row appears in the top line of the screen. 

• If the specified cursor relative row exceeds the bottom line currently visible on the screen, 
the cursor moves to the specified column in the bottom row of the screen; the data then 
rolls up until the specified row appears in the bottom line of the screen. 

If you specify only a <column number>, the cursor remains in the current row. Similarly, if you 
specify only a <row number>, the cursor remains in the current column. 
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Example 

To position the cursor (rolling the data if necessary) at the character residing 15 columns to the 
right and 25 rows above the current cursor position (within display memory), use the escape 
sequence: 

^&a+15c-25R 

Combining Absolute and Relative Addressing 

You may use a combination of screen relative, absolute and cursor relative addressing within a 
single escape sequence. 

For example, to move the cursor (and roll the text if necessary) so that it is positioned at the 
character residing in the 70th column of the 18th row below the current cursor position, use 
the escape sequence: 

^&a69c+18R 

Next, to move the cursor so that it is positioned at the character residing 15 columns to the 
left of the current cursor position in the 4th row currently visible on the screen, use the escape 
sequence: 

^&a-15c 3Y 

Similarly, to move the cursor (and roll the text up or down if necessary) so that it is positioned at 
the character residing in the 10th column of absolute row 48 in display memory, use the escape 
sequence: 

^&a9c 47R 
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Display Enhancements 

The ITE includes as a standard feature the following display enhancement capabilities: 

• Inverse Video - black characters are displayed against a white background. 

• Underline Video - characters are underscored. 


NOTE 

The Series 300 ITE does not provide Half-bright and Blinking enhance¬ 
ments. 


The display enhancements are used on a field basis. The field can not span more than one line. 
The field scrolls with display memory. Overwriting a displayable character in a field preserves 
the display enhancement. The enhancements may be used separately or in any combination. 

From a program or from the keyboard, you enable and disable the various video enhancements 
by embedding escape sequences within the data. The general form of the escape sequence is: 

^&d< enhancement code> 

where enhancement code is one of the uppercase letters A through O specifying the desired 
enhancement(s) or an @ to specify end of enhancement: 



@ 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

Underline 





X 

X 

X 

X 





X 

X 

X 

X 

Inverse Video 



X 

X 



X 

X 



X 

X 



X 

X 

End Enhancement 

X 

















Enhancement Character 


Note that the escape sequence for “end enhancement” (^&d@) or the escape sequence for 
another video enhancement, ends the previous enhancement. 
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Raster Control 

The terminal provides the ability to enable and disable the alphanumeric display. The escape 
sequences for these capabilities are: 

^*dE restores the alphanumeric display; enables writing to the alphanumeric display. 
^*dF disables further writing to the alphanumeric display. 

Accessing Color 

The monitors used for accessing color are the: 

• HP 35741 connected to an HP 98543A color video board, 

• HP 98782A connected to an HP 98545A color video board, 

• HP98782A plus 98700H connected to an HP98287A color video board with option 
700. 

To access color on a Series 300 computer, you must understand some simple terms: 

Color pair - two colors which define the foreground color (color of the characters) and the 
background color, respectively. A total of 64 color pairs are possible, but only eight can be 
displayed at any one time. 

Pen # - one of eight predefined color pairs. Pen 0 through pen 7 are initially defined as follows 
(re-defining a color pair is described later): 


Pen # 

Foreground 

Color 

Background 

Color 

0 

white 

black 

1 

red 

black 

2 

green 

black 

3 

yellow 

black 

4 

blue 

black 

5 

magenta 

black 

6 

cyan 

black 

7 

black 

yellow 


Pen #0 is the default pen selected by the terminal when writing to the display. 
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Selecting a Pen (Color Pair) 

By using an escape sequence, you can select a pen number other than pen #0 when writing 
to the display. Like other display enhancements, pen selection is used on a field basis. The 
field cannot span more than one line. That is, the pen selection is only active until a new-line 
character is encountered; then the default pen is re-selected. The escape sequence for selecting 
a pen is: 

<n> <parameter> 

where: 

<n> is the pen number, 

<parameter> is a single character that specifies the action. 

To select a pre-defined pen number, the necessary <parameter> is S. Thus, 

^&v 4S 

selects the pre-defined pen number 4. 

Changing Pen Definitions 

You may change the pre-defined color pair for any of the eight existing display pens. The three 
primary colors (red, green and blue) are used in various combinations to achieve the desired 
color. 

The combinations of red, green, and blue that define foreground and background colors can 
be specified in two notations. The first is RGB (Red-Green-Blue), and the second is HSL (Hue- 
Saturation-Luminosity). The notation must be selected before you can redefine pens (if no 
notation type is specified, the “ITE” uses the last notation specified, or RGB notation at power- 
up). To select a notation type, use the ^&v escape sequence used above: 

^&v <n> <parameter> 

where: 

<n> is 0 (for RGB) or 1 (for HSL), 

<parameter> is a single character that specifies the action. 

To select a notation, the necessary <parameter> is M. Thus, the sequence 
IM 

selects HSL notation. It does nothing more. 
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To specify the quantity of red (hue), green (saturation), and blue (luminosity) to appear in 
your background and foreground colors, the a, b, c, x, y, and z parameters are used. These 
parameters have the following meanings: 


a specifies red (hue) used in the foreground, 
b specifies green (saturation) used in the foreground, 
c specifies blue (luminosity) used in the foreground. 

X specifies red (hue) used in the background, 
y specifies green (saturation) used in the background, 
z specifies blue (luminosity) used in the background. 

Each a, b, c, x, y, and z parameter specified is preceded by a number in the range 0 through 1, 
in increments of 0.01. The following table gives the values needed to define the eight principle 
colors: 


Sample RGB/HSL Color Definition Values 


R 

G 

B 

Color 

H 

S 

L 

0 

0 

0 

Black 

X 

X 

0 

0 

0 

1 

Blue 

.66 

1 

1 

0 

1 

0 

Green 

.33 

1 

1 

0 

1 

1 

Cyan 

.5 

1 

1 

1 

0 

0 

Red 

1 

1 

1 

1 

0 

1 

Magenta 

.83 

1 

1 

1 

1 

0 

Yellow 

.16 

1 

1 

1 

1 

1 

White 

X 

0 

1 


X = don’t care (may be any value between 0 and 1) 


(Note that X’s in the above table represent “don’t care” situations.) 
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The following tables provide algorithms for explicitly defining the ranges of the parameters 
mentioned in the previous table for a computer with color video. 


HSL Definition Algorithm 


COLOR SELECTED 

parm. 1 

H RANGE 

parm. 2 

S RANGE 

parm. 3 

L RANGE 

BLACK 

don’t care 

don’t care 

< 0.25 

WHITE 

don’t care 

0.25 

>= 0.25 

RED 

.00- .08 

>= 0.25 

> = 0.25 

YELLOW 

.09- .24 

>= 0.25 

>= 0.25 

GREEN 

.25- .41 

>= 0.25 

>= 0.25 

CYAN 

.42- .58 

>= 0.25 

>= 0.25 

BLUE 

.59- .74 

>= 0.25 

>= 0.25 

MAGENTA 

.75- .91 

>= 0.25 

>= 0.25 

RED 

.92-1.00 

>= 0.25 

>= 0.25 


In the RGB color method, when N represents the largest-valued (most intense) color of the three 
color specifications, colors are selected as follows: 


RGB Definition Algorithm 


COLOR SELECTED 

parm.1 

RED RANGE 

parm. 2 

GREEN RANGE 

parm. 3 

BLUE RANGE 

BLACK 

<.25 or <N/2 

< 25 or <N/2 

< 25 or <N/2 

WHITE 

>=.25 and > = N/2 

> = .25 and > = N/2 

>=.25 and > = N/2 

YELLOW 

> = .25 and >=N/2 

> = .25 and > = N/2 

< 25 or <N/2 

GREEN 

<.25 or <N/2 

> = .25 and > = N/2 

< .25 or <N/2 

CYAN 

<.25 or <N/2 

> = .25 and > = N/2 

>= .25 and > = N/2 

BLUE 

< 25 or <N/2 

<.25 or <N/2 

> = .25 and > = N/2 

MAGENTA 

> = .25 and > = N/2 

<.25 or <N/2 

>= .25 and > = N/2 

RED 

> = .25 and > = N/2 

< 25 or <N/2 

<.25 or <N/2 
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One final parameter, 1, is needed. It is used to assign a pen number to the newly-defined color 
pair. Thus, the escape sequence for changing a color pair definition is: 

^&v <0|l>m <n>a <n>b <n>c <n>x <n>y <n>z <pen#>I 
where: 

<0|1> precede the m parameter to select either RGB or HSL notation. RGB is selected 
when 0 precedes the m parameter and HSL is selected when 1 precedes the m 
parameter. 

<n> is one of the legal values selected from either the HSL or RGB table. The table 
selected is determined by the value preceding the m parameter, as explained 
above. 

<pen#> is an integer in the range 0 thru 7 which, precedes the I parameter, defines that 
pen number to be the color pair specified by the preceding a, b, c, x, y, and z 
parameters. Omitting any a, b, c, x, y, or z parameter causes a value of 0 to be 
assigned to the omitted parameter by default. Note that the a, b, c, x, y, and z 
parameters are defined in the section, “Changing Pen Definitions”. 

Examples 

Om la Ob Oc Ox ly Oz 51 

This example re-defines pen 5 to specify red characters on a green background and it is equivalent 
to: 

^&v Om la ly 51 

since omitted parameters (a, b, c, x, y, z) are given default values of 0. 

^&v Im .66a lb Ic 3i Om Ic lx ly 61 

This example re-defines pen 3 to specify blue characters on a black background (HSL notation), 
and pen 6 to specify blue characters on a yellow background (RGB notation). This example 
illustrates how multiple pens can be defined on a single line using different notations. 

^&v 51 

This example re-defines pen 5 to specify a black foreground and a black background, using the 
previous notation type. 


NOTE 

Supplying neither a foreground nor a background color when defining a 
color pair causes both the foreground and background to be black. 
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Configuring the ITE 

The Internal Terminal Emulator is designed so that the various ITE characteristics can be con¬ 
figured quickly by displaying configure “menus” on the screen and then using system function 
keys to change the content of these menus. 


Configuration Function Keys 

To gain access to the configuration menus through the keyboard, press the | System | key. This 
causes the following softkey display to appear at the bottom of the screen: 



The function keys | f2 | (tab/mrgn), | f4 | (modes) and | f5 | (FlexDisc which is not implemented) were 
covered in the section “Using the Internal Terminal Emulator” along with a brief discussion on 
the function key [W\ (config). When you press | f8 | (config) a new softkey display appears at the 
bottom of your screen. 


terminal 


J 


Pressing (terminal) fills the display with the Terminal Configuration Menu which is covered 
next. 
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Terminal Configuration Menu 

After pressing (terminal) your display should look this: 


TERMINAL CONFIGURATION 



Language USASCII 
ReturnDef Si 

LocalEcho OFF CapsLock OFF Ascii 8 Bit NO 

XmitFnctn(A) NO InhEolWrp(C) NO 




NEXT 




DEFAULT 


DSPY FN 


config 




Description of Fields 

The TERMINAL CONFIGURATION menu contains a set of unprotected fields that you access 
using the | TAB | key. Note that all fields can be changed using function keys (NEXT) and 
[W\ (PREVIOUS) with the exception of ReturnDef which is changed using the function key [f^ 
(DSPY FN). 

There are seven fields which can be changed using the function keys as defined in the next 
section. These fields are described as follows: 

ReturnDef specifies the definition of the | RETURN | key. The default definition is an 

ASCII Si. The definition may consist of up to two characters. If the second 
character is a space, it is ignored and only the first character is used. 

Default: Si space 
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LocalEcho 


CapsLock 


specifies whether characters entered through the keyboard are both dis¬ 
played on the screen and transmitted to the host computer. 

LocalEcho is enabled using this escape sequence: 

^&klL 

When this field is enabled characters entered through the keyboard are 
both displayed on the screen and transmitted to the host computer. The 
default condition for LocalEcho is disabled or OFF, because HP-UX will 
echo the character’s itself. The following escape sequence disables Lo¬ 
calEcho: 

^&kOL 

determines whether the ITE generates the full 128-characters ASCII set or 
only Teletype-compatible codes. The following escape sequence enables 
(turns ON) LocalEcho: 

^&klC 

When CapsLock is enabled the ITE generates only Teletype-compatible 
codes: uppercase ASCII (00-5F, hex) and DEL (7F, hex). Unshifted alpha¬ 
betic keys (a-z) generate the codes for their uppercase equivalents. The 
{, |, and } keys generate the codes for [, \, and ] respectively. The key 
for generating ~ and ‘ is disabled. 

The following escape sequence disables (turns OFF) CapsLock: 

^&kOC 

When CapsLock is disabled the ITE generates the full 128-character ASCII 
set of codes. Note that the default condition for CapsLock is disabled or 
OFF. 
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XinitFnctn(A) 


InhEolWrp(C) 


determines whether escape code functions are executed at the ITE and 
transmitted to the host computer. The following escape sequence enters 
YES in the XmitFnctn field: 

^&slA 

The escape code sequences generated by control keys such as [T] and [Y] 
are transmitted to the host computer. If LocalEcho is ON, the function is 
also performed locally. 

The following escape sequence enters NO in the XmitFnctn field: 

^&sOA 

When NO is enter in this field the escape code sequences for the ma¬ 
jor function keys are executed locally but NOT transmitted to the host 
computer. 

Note that display functions will emit ^ Z and ^ Y to a host computer. 
The default condition for this field is NO. 

designates whether or not the end-of-line wrap is inhibited. The following 
escape sequence enters NO in the InhEolWrp(C) field: 

^&sOC 

With NO in the InhEolWrp(C) field, when the cursor reaches the right 
margin it automatically moves to the left margin in the next lower line (a 
local carriage return and line feed are generated). 

The following escape sequence enters YES in the InhEolWrp(C) field: 

^feslC 

With YES in the InhEolWrp(C) field, when the cursor reaches the right 
margin it remains in that screen column until an explicit carriage return 
or other cursor movement function is performed (succeeding characters 
overwrite the existing character in that screen column). 

The default condition for this field is NO. 
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Language 


changes the character set on your keyboard to one of the following when 
you press function key (f2 | or | f3 | : 

American USASCII Keyboard “USASCII” 

English (UK) Keyboard “UK” 

Canadian (English) Keyboard “ENGLISH CANADIAN” 

Katakana/JASCII Keyboard “KATAKANA” 

Swedish Keyboard “SVENSK” 

Norwegian Keyboard “NORSK” 

French Keyboard “FRANCAIS” 

German Keyboard “DEUTSCH” 

Spanish (European) Keyboard “ESPANOL EUR.” 

Canadian (French) Keyboard “CANADIAN FRANCAIS” 

Italian Keyboard “ITALIANA” 

Dutch Keyboard “NEDERLANDS” 

Finnish Keyboard “SUOMI” 

Danish Keyboard “DANSK” 

Swiss (German) Keyboard “SCHWEIZ-DEUTSCH” 

Swiss (French) Keyboard “SUISSE ROMAND” 

Swiss (German) Keyboard “SCHWEIZ-DEUTSCH*” 

Swiss (French) Keyboard “SUISSE ROMAND*” 

Spanish (Latin American) Keyboard “ESPANOL LAT” 

Flemish Keyboard “VLAAMS” 

Diagrams of the above keyboards can be found at the end of this article. 

Series 300 computers support two character sets which contain the spe¬ 
cial characters associated with all of the international languages. These 
character sets are: Roman 8 and KATAKANA. The following charts show 
these character sets. 
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ROMANS CHARACTER SET 

(USASCII PLUS ROMAN EXTENSION) 
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Roman 8 Character Set 
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To use the Roman 8 Character Set, read the section in this article entitled, 
“Character Entry Group”. The explanation for the | Extend char | key in 
this key group covers how to access both the Roman 8 and KATAKANA 
character sets. Note, if your ITE monitor is connect to an HP 98546A 
video compatibility interface card, then you need to set the CHAR SELECT 
switch on this card to 1 for the Roman 8 character set and 0 for the 
KATAKANA character set. 

The characters shown in the shaded areas on the “KATAKANA Character 
Set” chart are not provided on the medium resolution versions of the 
Model 310 and 320 computers. 
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KATAKANA Character Set 
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ASCII 8 Bit transmits from full set of 8-bit codes when enabled (YES) and transmits only 
codes less than 128 when disabled (NO). Note that the default conditions 
is NO. 

The following escape sequence enters YES in the ASCII 8 Bit field: 
^&kll 

The following escape sequence enters NO in the ASCII 8 Bit field: 
^&kOI 

Changing the Fields 

To change the fields in the Terminal Configuration Menu, press the | Tab | key until the cursor is 
located under the field you wish to change. Next, use the following function keys to change the 
state of the field. 

SAVE CFG saves the fields on the configuration menu which you have altered. 

NEXT changes the setting of the field you are presently in to the next setting in that 

field. For example, if USASCII is displayed in the Language field, pressing NEXT 
or \j^ would change the field to VLAAMS. 

PREVIOUS changes the setting of the field you are presently in to the previous setting in 
that field. For example, with VLAAMS displayed in the Language field, pressing 
PREVIOUS or would change the field back to USASCII. 

DEFAULT causes the fields in the menu to be filled with their default value. The default 
values are as shown in the TERMINAL CONFIGURATION display at the begin¬ 
ning of this section. The only exception is the Language field which defaults to 
the language option shipped with your system. 

DSPY FN enables and disables the display functions mode. Pressing the key once enables 
the display functions mode and pressing it a second time enables it. When en¬ 
abled, * appears in the function key label box. You use the display function mode 
for entering ASCII control characters in the ReturnDef field. Note that this im¬ 
plementation of display function is separate from that which is enabled/disabled 
via the mode selection keys. Enabling or disabling display functions mode us¬ 
ing this function key does NOT alter the effect of the DISPLAY FCTNS mode 
selection key (and vice versa). 
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config removes the menu from the screen and changes the function key labels to the 
following: 


V 


terminal 



To get back to the System softkey display from this state, press the | System | 
key. 
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ITE Escape Sequences 

Several Internal Terminal Emulator (ITE) keyboard functions can be activated or controlled by 
HP-UX through use of escape sequences. The effect is identical to using non-ASCII keys on the 
ITE keyboard. Escape sequences consist of the escape character followed by one or more visible 
(non-control) ASCII characters. 

The sequences listed in this section are recognized and executed by the ITE whether they are 
received from the data communication link or from the keyboard (in remote mode), although 
the keyboard is seldom used for escape sequences. If an illegal or unrecognized sequence 
is received, the ITE ignores the message and all subsequent data until one of the following 
characters is received: @, A thru Z, [, \, _, carriage-return (^), escape (^) or any ASCII 7-bit 

code less than the character space. 

Sequence Types 

There are two general categories of escape sequences. The two-character ITE control sequences 
are used primarily for ITE, screen, and cursor control. Most of these sequences are equivalent 
to keyboard operations that involve a single keystroke or the simultaneous pressing of two keys. 

The extended escape sequences consist of the escape-code character followed by at least two 
subsequent characters. They are used, either for functions that are not included in the two- 
character sequences, or for sequences whose inherent complexity requires two or more characters 
in addition to the escape character in order to define the operation. Absolute and relative cursor 
addressing are examples of operations that require longer control sequences. 
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Escape Sequences for ITE Control 


Escape 

Code 

Function 


Set tab 


Clear tab 

^3 

Clear all tabs 

^4 

NOT IMPLEMENTED (Set left margin) 

^5 

NOT IMPLEMENTED (Set right margin) 

^9 

NOT IMPLEMENTED (Clear all margins) 


NOT IMPLEMENTED (Makes the terminal program wait approximately 
one second.) 


Cursor up 


Cursor down 


Cursor right 


Cursor left 


Hard reset (power on reset of ITE) 


Cursor home down 


Move cursor to the left margin 

®GH 

Cursor home up 


Horizontal tab 


Clear screen from cursor to the end of memory. 


Clear line from cursor to end of line 


Insert line 


Delete line 


Delete character 


Start insert character mode 


End insert character mode 


Roll up 


Roll down 


Next page 


Previous page 
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Escape Sequences for ITE Control (continued) 


Escape 

Code 

-1 

Function 


NOT IMPLEMENTED (Format mode on) 


NOT IMPLEMENTED (Format mode off) 


Enables display functions mode 


Disables display functions mode 


NOT IMPLEMENTED (Start unprotected field) 


NOT IMPLEMENTED (End unprotected/transmit-only field) 


NOT IMPLEMENTED (Primary terminal status request) 


Sense cursor position(relative) 


Sense cursor position (absolute) 


NOT IMPLEMENTED (Unlock keyboard) 


NOT IMPLEMENTED (Lock keyboard) 


NOT IMPLEMENTED (Transmit a block of text to computer) 


NOT IMPLEMENTED (Modem disconnect) 


Soft reset (of ITE) 


Cursor home up. 


Back tab 


NOT IMPLEMENTED (Begin User Key Definition mode) 


NOT IMPLEMENTED (End User Keys Definition mode) 


NOT IMPLEMENTED (Begin Memory Lock mode) 

V 

NOT IMPLEMENTED (End Memory Lock Mode) 


Default value for softkey f1 


Default value for softkey 12 

'br 

Default value for softkey f3 


Default value for softkey f4 

'bt 

Default value for softkey f5 


Default value for softkey f6 

'bv 

Default value for softkey f7 


Default value for softkey f8 


NOT IMPLEMENTED (Initiate terminal self test) 


NOT IMPLEMENTED (Secondary terminal status request) 
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Extended Escape Sequences 


Escape Code 
Sequence 

Function 

^&a <col>c <row>Y 

Moves the cursor to column “col” and screen row “row” on 
the screen (screen relative addressing). The row or column 
values may be used by themselves in this escape sequence 
(e.g ^&a <col> C or ^&a <row> Y). The value you choose 
to leave out remains as previously set. 

^&a <col>c <row>R 

Moves the cursor to column “col” and row “row” in memory 
(absolute addressing). The row or column values may be used 
by themselves in this escape sequence (e.g ^&a <col> C or 
^&a <row> R). The value you choose to leave out remains 
as previously set. 

±<col>c ±<row>y 

Moves the cursor to column “col” and row “row” (on the 
screen) relative to its present position (“col” and “row” are 
signed integers). A positive number indicates right or down¬ 
ward movement and a negative number indicates left or up¬ 
ward movement. The row or column values may be used by 
themselves in this escape sequence (e.g ^&a di<col> C or 
di<row> Y). The value you choose to leave out remains 
as previously set. 

d=<col>c ±<row>R 

Moves the cursor to column “col” and row “row” (on the 
screen) relative to its present position (“col” and “row” are 
signed integers). A positive number indicates right or down¬ 
ward movement and a negative number indicates left or up¬ 
ward movement. The row or column values may be used by 
themselves in this escape sequence (e.g ^&a ib<col> C or 
^&a di<row> R). The value you choose to leave out remains 
as previously set. 

^&qOL 

NOT IMPLEMENTED (Unlock configuration) 

^&qlL 

NOT IMPLEMENTED (Lock configuration) 


<char> Selects the display enhancement indicated by 
<char> to begin at the present cursor position. <char> 
can be 0 or A thru 0. 
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Extended Escape Sequences (continued) 


Escape Code 


Sequence 

Function 

^jtk<x>A 

AUTO LF enable: x=l; disable: x=0 

^<!k<x>B 

NOT IMPLEMENTED (BLOCK enable: x=l; disable: x=0) 

^iik<x>C 

Caps Lock enable: x=l; disable: x=0 

^&k<x>I 

ASCII 8 Bits enable: x=l; disable: x=0 

^&k<x>J 

NOT IMPLEMENTED (FrameRate 50 Hz : x=l; 60 Hz : x=0) 

*b&k<x>L 

LocalEcho enable: x=l; disable: x=0 

^&k<x>M 

NOT IMPLEMENTED (MODIFY ALL enable: x=l; disable: 
x=0) 

^&k<x>N 

NOT IMPLEMENTED (SPOWLatch enable: x=l; disable: 
x=0) 

^&k<x>P 

Caps Mode is primarily used as a typing convenience and 
affects only the 26 alphabetic keys. When it is enabled, all 
unshifted alphabetic keys generate uppercase letters and all 
shifted alphabetic keys generate lowercase letters. 


enable: x=l; disable: x=0 

^&k<x>R 

REMOTE enable: x=l; disable: x=0 

^&s<x>A 

xmitFnctn(A) enable: x=l; disable: x=0 

^&s<x>B 

NOT IMPLEMENTED (SPOW(B) enable: x=l; disable: x=0) 

^&s<x>C 

InhEolWrp(C) enable: x=l; disable: x=0 

^&s<x>D 

NOT IMPLEMENTED (Line/Page(D) enable: x=l; disable: 
x=0) 

^&s<x>G 

NOT IMPLEMENTED (InfHndShk(G) enable: x=l; disable: 
x=0) 

^iES<X>H 

NOT IMPLEMENTED (Inh DC2(H) enable: x=l; disable: 
x=0) 

^&w 12F 

Turns on the display window (top 24 rows) 

^&w 13F 

Turns off the display window 
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Extended Escape Sequences (continued) 


Escape Code 
Sequence 

Function 

^*d <parameters> 

List of <parameters> for display control: 

E Turns on alphanumeric display; 

F Turns off alphanumeric display. 

When terminating a string of escape sequences with these 
parameters use a capital letter. 

s <parameter> 

Read device I.D. Status is parameter number 1. 

A 

V 

Enables and disables the function keys (fl thru f8). If x equals: 

A Display the Modes set of function key labels, 

B Enable the User function keys. (The user key labels are 
displayed.) 

Remove the function key labels from the screen. The User 
function keys, however, are still active. 

< attribute > a <key>k 

Defines the function keys. Information on how this is done 
can be found in the function key group section of this manual 
under the definition of user keys. 

^&v n< parameter > 

Read the section in this article “Accessing Color”. 


If an escape sequence is not recognized, the terminal ignores subsequent characters until ASCII 
decimal characters 0 thru 31 or 64 thru 95 is received, terminating the sequence. Note that ^ 
will terminate the old sequence and start a new one. 
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Keyboard Diagrams for Other Languages 

This section shows diagrams of the types of HP 46020A keyboards which are available to the 
Series 300 user. The keyboard option you now have can be configured to any of the languages 
by use of the TERMINAL CONFIGURATION menu previously mentioned in this article. 

To change to another keyboard language use the terminal configuration menu and select the 
Language field you want. Then change the ASCII 8 Bit field to YES. Next, save the changed 
configuration menu. Note that the languages accessed through the terminal configuration menu 
are not available in the vi editor. The ui editor only uses the first 128 ASCII characters of your 
systems particular character set. Also notice that, if you are running /bin/sh or /bin/csh, you 
must use sttp to enable your shell environment to use all 8 bits of the code. For more information 
on your keyboard, read the appropriate manual sent with your system. 

You will notice as you look at the keyboards that a majority of the character key and numeric 
key labels have changed. To use your keyboard effectively in any one of these languages, you 
will have to re-label the key caps or purchase a keyboard appropriate to the language you are 
using. 
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HP 46020A Keyboards 

These keyboards are labeled according to the language they are to be used with. 



American USASCII Keyboard “USASCII” 



English (UK) Keyboard “UK” 
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Canadian (English) Keyboard “ENGLISH CANADIAN” 



Katakana/JASCII Keyboard “KATAKANA” 
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HP-UX and the HP 9000 Model 520 
As System Console 


The system console is the terminal to which HP-UX sends system loader messages and soft system 
error messages. Like other terminals on an HP-UX system, it is also used for general system access 
(such as logging in, running programs, and entering data). The system console: 

• must be connected to the computer via select code 0. 

• must not be connected via a modem. 

• must have a device file named /dev/console. 

Each system must have a system console. When HP-UX is run on the HP 9000 Model 520, the 
computer’s keyboard and display act as the system console. This article describes the HP 9000 
Model 520 as a terminal and as system console. It also discusses the methods of accessing the 
“terminal’s” features: from the keyboard and from a program or command (via escape sequences). 

HP-UX treats your HP 9000 Model 520 as six independent devices. The first device is a 32-bit 
mini-computer composed of a central processing unit, an I/O processor and memory. The second, 
third, fourth and fifth devices are: the built-in thermal printer, the built-in flexible disc drive, the 
built-in Winchester disc drive, and the graphics display. The sixth device is the computer’s keyboard 
and display. This last device is the terminal and system console discussed in this article. 

The display portion of the “terminal” consists of a display screen and display memory. The display 
cursor (a blinking underscore on the screen) indicates where the next character entered appears. As 
you enter characters, each is displayed at the cursor position, the ASCII code for the character is 
recorded at the associated position in display memory, and the cursor moves to the next character 
position on the screen. As the screen becomes full, newly entered data causes existing lines to be 
forced off the screen. Data lines forced off the screen are still maintained in display memory and can 
subsequently be moved back onto the screen. The size of display memory is determined by the 
HP-UX configuration. Once the display memory is full, additional data entered causes the older 
data in display memory to be lost. 

Throughout this article, the sequence \E represents the escape character. Supplying an 
invalid escape sequence causes that sequence to be ignored. Escape sequences with optional or 
required parameters (referred to as “parameterized escape sequences”) must be terminated by an 
upper case character before the sequence is implemented. 
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The Keyboard 

The Model 520’s keyboard is divided into major functional groups: the alphanumeric group, the 
numeric pad group, the display control group, the edit group, and the function group. Each 
function group is discussed in the sections below, with an emphasis on features and their access. 

Alphanumeric Group 

This group of keys is similar to a standard typewriter keyboard and consists of the alphabetic, 
numeric, and symbol keys. Included are lower and uppercase alphabetic characters, ASCII control 
codes, punctuation characters, and some commercial symbols. 

Numeric Pad Group 

The numeric group of keys is located to the right of the alphanumeric keys. The layout of the 
numeric key pad is similar to that of a standard office calculator. These keys are convenient for 
high-speed entry of large quantities of numeric data. 

Display Control Group 

The display control group consists of the keys that control the location of the cursor on the display. 
Each display control key and its function is described in the sections that follow. The escape code 
for accessing each display control feature is provided with each display control key. Some display 
control features can only be accessed via an escape sequence; no key is associated with the feature. 
The escape code for such features is also provided in the sections that follow. 

Setting and Clearing Margins 

You can redefine the left and/or right margin. These margins affect the cursor positioning for certain 
functions (such as carriage-return, home up, home down, etc.) and establish operational bounds 
for the insert character and delete character functions. In addition, the left margin is always an 
implicit tab stop. Data to the left of the left margin or to the right of the right margin is still accessible. 

When you are entering data through the keyboard and the cursor reache s the righ t margin, it 
automatically moves to the left margin in the next lower line. When you press ( RETURN ] the cursor 
moves to the left margin in the current line if auto line feed mode is disabled or to the left margin 
in the next lower line if auto line feed mode is enabled. 

Margins can be set with the AIDS keys (discussed in a later section) or with escape sequences; 
\E4 - set the left margin at the current cursor location. 

\E5 - set the right margin at the current cursor location. 

\E9 - clear both margins; by default the left margin becomes 1, the right margin becomes 
80. 

Attempting to set the left margin to the right of the right margin (or the right margin to the left of 
the left margin) causes the new margin to be rejected; the system beeps to notify you that the 
new margin was not accepted. 
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Setting and Clearing Tab Stops 

You can define a series of tab stops to which you can move the cursor using the tab and back tab 
functions sho wn below. From the keyboard you set and clear tab stops using the [ TAB SET ] and 
( TAB CLEAR ) keys. To set a tab stop, move the cursor to the desired location and press 
( TAB SET ] . To clear a tab stop, move the cursor to the tab stop position and press [ TAB CLEAR ] . 
Additionally, you may use the functions provided with the AIDS keys (discussed in a later 
section) to set and clear tab stops. 

Note that the left margin is always an implicit tab stop and cannot be cleared. The escape 
sequences to set and clear tab stops are: 

\E1 - set a tab stop at the current cursor position. 

\E2 - clear a tab stop previously set at the current cursor position. 

\E3 - clear all tab stops currently set. Note that this feature is available only from softkeys 
(as are the margin functions described above). 


Cursor Control 

Several keys exist on keyboard for changing the location of the cursor; 


Key 

Escape 

Sequence 

Feature 

( t j 

\EA 

Move the cursor up one row in the current column position. Holding the 
key down causes the cursor to move continuously, row by row, until the 
key is released. When the cursor is in the top row of the screen, moving 
the cursor up actually moves the cursor to the same column position in 
the bottom row of the screen. 

( i j 

\EB 

Move the cursor down one row in the current column position. Holding 
the key down causes the cursor to move continuously, row by row, until 
the key is released. When the cursor is in the bottom row of the screen, 
moving the cursor down actually moves the cursor to the same column 
position in the top row of the screen. 

[ - ) 

\EC 

Move the cursor right one position in the current line; if the current 
position is the right margin, the cursor is moved to the left margin of the 
next line. Holding the key down causes the cursor to move continuous¬ 
ly, column by column, until the key is released. 

( - ) 

\ED 

Move the cursor left one position in the current line; if the current 
position is the left margin, the cursor is moved to the right margin of the 
previous line. Holding the key down causes the cursor to move con¬ 
tinuously, column by column, until the key is released. 


\EH or 
\Eh 

Home up: moves the cursor to the left margin in top row of the 
screen and rolls the text in display memory down as far as possible so 
that the first line in display memory appears in the top row of the 
screen. 


\EF 

Home down: moves the cursor to, the left margin in the bottom line 
of the screen and rolls the text in display memory up as far as 
necessary so that the last line in display memory appears immediate¬ 
ly above the cursor position. 
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Escape 

Sequence 

Feature 

\EG 

Move the cursor to the left margin. 

\EI 

Move the cursor forward to the next tab stop. 

\Ei 

Move the cursor backwards to the previous tab stop. 

\ES 

Roll the text in display memory up one row on the screen. The top 
row rolls off the screen, the remaining data rolls up one line on the 
screen, and a new line of data rolls from display memory into the 
bottom line of the screen. When the key is held down, the text 
continues to roll upward until the key is released or until the final line 
of data in display memory appears in the top row of the screen. In 
the latter case, pressing or continuing to press down the key has no 
further effect. The roll up and roll down functions are shown in the 
illustrations at the end of this section. 

\ET 

Roll the text in display memory down one row on the screen. The 
bottom row rolls off the screen, the remaining data rolls down one line 
on the screen, and a new line of data rolls from the display memory into 
the top line of the screen. When the key is held down, the text continues 
to roll down until the key is released or until the first line of data in 
display memory appears in the top row of the screen. In the latter case, 
pressing or continuing to press down the key has no further effect. The 
roll up and roll down functions are shown in the illustrations at the end 
of this section. 

\EU 

Roll the text in display memory up so that the next page (see the 
explanation below) of data replaces the current page on the screen. If 
the key is held down, the operation is repeated until the key is released 
or until the final line in display memory appears in the top line of the 
screen. In the latter case, pressing or continuing to hold down the key 
has no further effect. 


The cursor is placed at the left margin, at the top row of the display. 

\EV 

Roll the text in display memory down so that the previous page (see the 
explanation below) of data replaces the current page on the screen. If 
the key is held down, the operation is repeated until the key is released 
or until the first line in display memory appears in the top line of the 
screen. In the latter case, pressing or continuing to hold down the key 
has no further effect. 


The cursor is placed at the left margin, at the top row of the display. 
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The data in display memory can be accessed (displayed on the screen) in blocks that are known as 
“pages”. A page consists of 24 lines of data. The current page is that sequence of lines which 
appears on the screen at any given time. The previous page is the preceding 24 lines in display 
memory. The next page is the succeeding 24 lines in display memory. This concept, along with the 
concept of rolling data through the display screen and memory, are shown in the following illustra¬ 
tions. 
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Edit Group 

The edit group consists of the keys that allow you to modify the data presented on the screen. 
Currently, however, the edited data cannot be read back by the system. Typically, these features 
are used to modify data presented by programs. For example, the vi text editor program uses these 
features. 

You can edit data on the screen by simply overstriking the old data. In addition, the following edit 
keys and escape sequences may be used: 



Escape 

Sequence 

Function 

\EJ 

Removes from display memory, all characters from the current location 
of the cursor to the end of display memory. 

\EK 

Removes from display memory, all characters from the current location 
of the cursor to the end of the current line. 

\EL 

The text line containing the cursor and all text lines below it roll down¬ 
ward one line, a blank line is inserted in the screen row containing the 
cursor, and the cursor moves to the left margin of the blank line. Hold¬ 
ing the key down causes the operation to be repeated until the key is 
released. 

\EM 

The text line containing the cursor is deleted from display memory, all 
text lines below it roll upward one row, and the cursor moves to the left 
margin. Holding the key down causes the operation to be repeated until 
the key is released or until there are no subsequent lines of text remain¬ 
ing in display memory. In the latter case, pressing or continuing to hold 
down this key has no further effect. 

\EP 

The cursor remains stationary while the character at the current cursor 
location is deleted. All characters between the cursor and the right 
margin move left one column and a blank moves into the line at the 
right margin. 


This function is meant to be used within that portion of the screen 
delineated by the left and right margins. If the cursor is positioned to the 
left of the left margin, the delete character function works as previously 
described. If the cursor is positioned beyond the right margin, the delete 
character function affects those characters from the current cursor posi¬ 
tion through the right boundary of the screen. 


If the key is held down, the terminal continues to delete characters until 
either the key is released or no characters remain between the cursor 
position and the right margin. In the latter case, pressing or continuing 
to hold down this key has no further effect. 

\EQ 

Turn on the insert character mode (see the description that follows). 

\ER 

Turn off the insert character mode (see the description that follows). 
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Insert Character Mode 

When the “insert character” editing mode is enabled, characters entered through the keyboard or 
received from the computer are inserted into display memory at the cursor position. Each time a 
character is inserted, the cursor and all characters from the current cursor position through the right 
margin move one column to the right. Characters that are forced past the right margin are lost. 
When the cursor reaches the right margin, it moves to the left margin in the next lower line and the 
insert character function continues from that point. 

The edit function is meant to be used within that portion of the screen delineated by the left and 
right margins. If the cursor is positioned to the left of the left margin, the insert character function 
works as previously described. If the cursor is positioned beyond the right margin, however, the 
insert character function affects those characters between the current cursor position and the right 
boundary of the screen. In such a case, when the cursor reaches the right boundary of the screen, it 
moves to the left margin in the next lower line and the insert character function continues from that 
point as described in the previous paragraph. 

When the insert character mode is enabled (and softkey labels are displayed), the characters IC are 
displayed between the fourth and fifth function key labels. These characters are displayed to remind 
you that you are in the insert character mode. 

Function Key Group 

Accross the top right of the keybo ard are 1 6 keys labeled (o 16] through [i5 31) . HP-UX recog¬ 
nizes only the first 8 keys, (o 16) through [7 23 ] ^ as function keys. The functions performed by 

these keys change dynamically as you use the terminal. At any given time the applicable 
function labels for these keys appear across the bottom of the display screen. However, soft- 
keys are not supported by HP-UX (softkeys are those keys physically located on the display). 

Modes 

When you press the “MODES” key [12 28) , the eight function keys are redefined. Pressing a 
redefined key allows access to one of the “modes” described in the following sections. The 
labels for the redefined keys are shown below (keys without labels are undefined): 

[0 16] [1 17) (2 18] [3 19] (4 20 ) (5 21 ) (6 22 ] (7 23] 

REMOTE DISPLAY AUTO 

MODE FUNCT LF* 

You may use these function keys to enable and disable various terminal operating modes. Each 
defined mode selection key alternately enables and disables a particular mode. When the mode is 
enabled, an asterisk (*) appears in the associated key label on the screen (for example, auto line 
feed mode is enabled in the key menu above). 

When the remote mode is enabled and a key is pressed, the terminal transmits the associated 
ASCII code to HP-UX. In local mode (remote mode is disabled), when an alphanumeric key is 
pressed the associated character is displayed at the current cursor position on the screen (nothing is 
transmitted to HP-UX). 
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When the auto line feed mode is enabled, an ASCII line feed control code is automatically 
appended to each ASCII carriage return control code generated through the keyboard. ASCII 
carriage return control codes can be generated through the keyboard in any of the following ways: 

• By pressing either ( EXECUTE ) or ( RETURN ) (HP-UX treats these keys identically). 

• By simultaneously pressing the keys ( CTRL) and ( M ] . 

• By pressing any of the user keys ( [o 16] through [7 23 ] provided that a carriage-return 

code is included in the particular key definition. 

When the display functions mode is enabled, the terminal operates as follows: 

• In local mode, it displays ASCII contro l codes and escape sequences but does not execute 
them. For example, if you press [ ^ ] , the terminal displays \ED on the screen but does 
not move the cursor one character to the left. 

• In remote mode, it transmits ASCII control cod es and escape sequences but does not 
execute them locally. For example, if you press (ROLL \] , the terminal transmits \ES but 
does not perform the “roll up” function. If local echo is enabled (ON) then the \ES is also 
displayed on the screen. Local echo specifies that the character is not only transmitted, but 
displayed on the terminal as well. 

These same mode selection functions can be accessed via the escape sequences: 

\E&k <x>R - when x is 0, the remote mode is off; when x is 1, the remote mode is on. 

\E&k <x>A - when x is 0, auto line feed mode is off; when x is 1, auto line feed mode is 

on. 

\EY - enables display functions; when enabled, all printing and non-printing 

characters are displayed. 

\EZ -disables display functions; when disabled, only printing characters are 

displayed. 

AIDS 

When you press the AIDS key (12 28) , another menu is displayed, showing a single, defined key 
(the MARGINS/TABS key). When this key is pressed, the eight function keys become general 
control keys that you use for setting and clearing margins and tabs from the keyboard. Pressing 
one of the defined keys causes the terminal to issue the appropriate escape sequence for the 
function selected. These escape sequences and their function are discussed with the Display 
Control Group, earlier in this section. 

Note that the MARGINS and TABS keys only send their associated escape sequences to 
HP-UX when display functions are enabled and when the A Strap is set (discussed later in this 
article). If these conditions are not met, the escape sequence is executed locally but is not sent 
to HP-UX. 
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User Keys _ 

When you press the USER KEYS key [i4 30) ^ the eight function keys display the user defined key 
labels. In the following section (“User-definable Keys”), the function of the user keys and the 
procedure for defining them is described. To remove the user key labels from the screen (while 
still retaining their defined functions), press (12 28) (the AIDS key) while holding the ( SHIFT ) key 
depressed. 

The USER KEYS key always toggles between displaying the current key labels and the user key 
labels. 

User-definable Keys 

The eight function keys ( [o I 6 ) through {7 23 ) ), besides performing the terminal control func¬ 

tions described above, can be defined by a program. In this context, “defined” means: 

• You can assign to each key a string of ASCII alphanumeric characters and/or control codes 
(such as carriage return or line feed). 

• You can specify each key’s operation attribute: whether its key definition is to be executed 
locally at the terminal, transmitted to the computer, or both. 

• You can assign to each key an alphanumeric label (up to 16 characters) which, in user keys 
mode (i.e. when the USER KEYS key (i4 30) is pressed), is displayed across the bottom of 
the screen. 

The definition of each user key may contain up to 80 characters (alphanumeric characters, ASCII 
control characters, and explicit escape sequence characters). 

To define a user-definable key, enter the escape sequence: 

\ E f (attribute > < K e v > (label length > < string length > < label > < string > 

where < a 11 r i b u t e > is a two character combination from the list Oa, la, or 2a. The default 
value for < a 11 r i b u t e > is 0 a. The attribute character specifies whether the definition 
of the particular user key is to be: 

a. Treated in the same manner as the alphanumeric keys (Oa). 

If the terminal is in local mode, the definition of the key is executed locally. If the 
terminal is in remote mode and local echo is disabled (OFF), the definition of 
the key is transmitted to the computer. If the terminal is in remote mode and 
local echo is enabled (ON), the definition of the key is both transmitted to the 
computer and executed locally. 

b. Executed locally only (la). 

c. Transmitted to the computer only (2a). 

When the transmit-only attribute (2a) is designated, the particular user key has 
no effect unless the terminal is in remote mode. A transmit-only user key 
appends the appropriate terminator to the string (either carriage-return or car¬ 
riage-return/line feed, depending on the state of Auto Line Feed). 

•( K e y > is a two character identifier specifying the key to be defined. The key is 
specified by a value in the range Ik through 8k (Ik is the default). For example, to 
specify the fifth user key, enter 5k for < K e y >. Note that this differs from the physical 
key labels on the HP 9000 Model 520’s keyboard (they are labeled 0 through 7). 
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(label length > is the number of characters in the key label. Acceptable values are 
in the range Od through 16d. Specifying a zero length causes the key label to remain 
unchanged. Od is the default value for the label length. 

(string 1 e n ^ t h > is the length of the string forming the key definition. Acceptable 
values are in the range -IL through SOL; IL is the default. Entering a string length 
value of zero causes the key definition to remain unchanged. A string length value of 
-1 causes the key definition to be erased. 

< label > is the character sequence for the label. 

< string > is the character sequence for the key definition. 

The < a 11 r i b u t e >, < K e y >, (label length >, and < string 1 e n § t h > parameters may 
appear in any sequence but must precede the label and key definition strings. You must use an 
uppercase identifier (A, K, D, or L) for the final paramater and a lowercase identifier (a, k, d, or 
1) for all preceding parameters. If any of the four fields are omitted, their default values are used. 
At least one of the parameters must be specified because its uppercase identifier is needed to 
terminate the sequence. 

Following the parameters, the first 0 through 16 characters, as designated by 
(label length >, constitute the key’s label and the next 0 through 80 characters, as desig¬ 
nated by < string 1 en ^ t h >, constitute the key’s definition string. The total number of char¬ 
acters (alphanumeric data, ASCII control codes such as carriage-return and line feed, and 
explicit escape sequence characters) in the label string can exceed 16, but only the first 16 
characters are used. The same is true for the destination string; only the first 80 characters are 
used. 

The initial (power-on) definition of the user keys is: 

• all keys are transmit-only (attribute is 2a). 

• the user key labels are f 1 through f 8. 

• definit ions are \Ep, \Eq, \Er, \Es, \Et, \Eu, \Ev, and \Ew for keys [o 16) through 

(7 23 ] ^ respectively. 

Controlling Function Key Labels Programmatically 

From an application program you can control the function key labels display by using the 
following escape sequences: 

\E&j@ Disable the function keys and remove all key labels from the screen. Note: If a 
function key is hit while the terminal is in remote, the function key is transmitted 
whether or not function key labels are displayed on the screen. 

\E&jA Enable the mode selection keys. 

\E&jB Enable the user-defined labels. 

\E&jR Enable screen labels. 

\E&jS Disable screen labels. 
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The Display 

The “terminal’s” display has many features of its own, such as video highlights (inverse video and 
blinking), raster control, cursor sensing and addressing, and color highlight control (for Model 520 
Computers equipped with a color display). These functions are accessed only through escape 
sequences and are discussed in the sections that follow. 

Memory Addressing Scheme 

Display memory positions can be addressed using absolute or relative coordinate values. Display 
memory is made up of 80 columns (0 - 79) and any number of 24 line pages (specified by the 
HP-UX configuration). As shipped to you, the display memory has 48 lines (0 - 47) of 80 characters 
(2 screens). The amount of display memory can be determined from byte 0 of the primary terminal 
status (discussed in the section entitled “The Terminal”, later in this article). The types of addressing 
available are absolute (memory relative), screen relative, and cursor relative. 

Row Addressing 

The figure below illustates the way that the three types of addressing affect row or line numbers. 
The cursor is shown positioned in the fourth row on the screen. Screen row 0 is currently at row 6 of 
display memory. In order to reposition the cursor to the first line of the screen the following three 
destination rows could be used: 

Absolute: row 6 
Screen Relative: row 0 
Cursor Relative: row -3 



a.) Absolute ; row 6 


b.) Screen Relative: row 0 c.) Cursor Relative: row-3 


Row Addressing 


Column Addressing 

Column addressing is accomplished in a manner similar to row addressing. There is no difference 
between screen and cursor relative column addressing. The figure below illustrates the difference 
between absolute and relative addressing. The cursor is shown in column 5. 
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Whenever the row or column addresses exceed those available, the largest possible value is 
substituted. In screen relative addressing, the cursor cannot be moved to a row position that is not 
currently displayed. For example, in the cursor relative portion of the figure above (showing row 
addressing), a relative row address of - 10 would cause the cursor to be positioned at the top of the 
current screen (relative to row —3). Column positions are limited to the available screen positions. 
For example, in the following illustration, the absolute column addressing example shows limits of 0 
and 79, while the relative column addressing example shows limits of —5 and 74. The cursor 
cannot be wrapped around from column 0 to column 79 by specifying large negative values for 
relative column positions. 


0123456789...79 

I 

I 

V_ ) 


a.) Absolute 


-5 -4 -3 -2 -1 0 +1 +2 +3 ... +74 

( ^ ^ 

I 

I 

V_ ) 

b.) Relative 


Column Addressing 


Cursor Sensing 

The current position of the screen cursor can be sensed. The position returned can be the absolute 
position in the display memory or the location relative to the current screen position. (Absolute and 
relative addresses are discussed in the section “Cursor Addressing”.) 

Cursor sensing is available only when the “terminal” is in remote mode. 

Absolute Sensing 

When a program sends the escape sequence \Ea to the terminal, the terminal returns to the 
program an escape sequence of the form \E&a xxxc yyyR, where xxx is the absolute column 
number and yyy is the absolute row number of the current cursor position. You will later see 
that this escape sequence is identical to the escape sequence for an absolute move of the 
cursor. 

Relative Sensing 

When a program sends the escape sequence \E', the terminal returns to the program an escape 
sequence of the form \E&a xxxcyyyY where xxx is the column number of the cursor and yyy 
is row position of the cursor relative to screen row 0. This escape sequence is identical to the 
escape sequence for a relative move of the cursor (discussed later in this article). 

Cursor Positioning 

The cursor can be positioned directly by giving memory or screen coordinates, or by sending the 
escape codes for any of the keyboard cursor positioning operations. 
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Screen Relative Addressing 

To move the cursor to any character position on the screen, use any of the following escape 
sequences: 

\E&a<column number> c <row number>Y 
\E&:a<row number> y <column number>C 
\E&a<column number>C 
\E&a<row number>Y 

where <column number> is a decimal number specifying the screen column to which you wish to 
move the cursor. Zero specifies the leftmost column. 

<row number> is a decimal number specifying the screen row (0 - 23) to which you wish to 
move the cursor. Zero specifies the top row of the screen; 23 specifies the bottom row. 

When using the escape sequences for screen relative addressing, the data on the screen is not 
affected (the cursor may only be moved around in the 24 rows and 80 columns currently displayed, 
thus data is not scrolled up or down). 

If you specify only <column number>, the cursor remains in the current row. Similarly, if you 
specify only <row number>, the cursor remains in the current column. 

Example 

The following escape sequence moves the cursor to the 20th column of the 7th row on the screen: 
\E&:aGy 19C 

Absolute Addressing 

You can specify the location of any character within display memory by supplying absolute row and 
column coordinates. To move the cursor to another character position using absolute addressing, 
use any of the following escape sequences: 

\E&a<column number> c <row number>R 
\E&a<row number> r <column number>C 
\E&a<column number>C 
\E&a<row number>R 

where <column number> is a decimal number (0 - 79) specifying the column coordinate (within 
display memory) of the character at which you want the cursor positioned. Zero specifies the 
first (leftmost) column in display memory, 79 the rightmost column. 

<row number> is a decimal number (0-max) specifying the row coordinate (within display 
memory) of the character at which you want the cursor positioned. Zero specifies the first 
(top) row in display memory, max specifies the last. The value of max is specified as: 

[24 (lines/page) X num_page (pages)] - 1 

where num_page is the number of pages of display memory specified by the system con¬ 
figuration. As shipped to you, the configuration dictates that 2 pages of display memory be 
allocated. Thus, the last row that can be addressed is 47. 
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necessary) in order to position the cursor at the specified data character. The cursor and data 
movements occur as follows: 

• If a specified character position lies within the boundaries of the screen, the cursor moves to 
that position; the data on the screen does not move. 

• If the absolute row coordinate is less than that of the top line currently visible on the screen, the 
cursor moves to the specified column in the top row of the screen; the data then rolls down 
until the specified row appears in the top line of the screen. 

• If the absolute row coordinate exceeds that of the bottom line currently visible on the screen, 
the cursor moves to the specified column in the bottom row of the screen; the data then rolls 
up until the specified row appears in the bottom line of the screen. 

If you specify only a < column number>, the cursor remains in the current row. Similarly, if you 
specify only a <row number>, the cursor remains in the current column. 

Example 

To position the cursor (rolling the data if necessary) at the character residing in the 60th column of 
the 27th row in display memory, the escape sequence is: 

\E&;a2Gr50C 

Cursor Relative Addressing 

You can specify the location of any character within display memory by supplying row and column 
coordinates that are relative to the current cursor position. To move the cursor to another character 
position using cursor relative addressing, use any of the following escape sequences: 

\E&a +/- <column number> c +/-<row number>R 
\E&a +/— <row number> r +/-<column number>C 
\E&a +/-<column number>C 
\E&a +/- <row number>R 

where <column number> is a decimal number specifying the relative column to which you wish to 
move the cursor. A positive number specifies how many columns to the right you wish to 
move the cursor; a negative number specifies how many columns to the left. 

<row number> is a decimal number specifying the relative row to which you wish to move 
the cursor. A positive number specifies how many rows to the right you wish to move the 
cursor; a negative number specifies how many rows to the left. 

When using the above escape sequences, the data visible on the screen rolls up or down (if 
necessary) in order to position the cursor at the specified data character. The cursor and data 
movements occur as follows: 

• If a specified character position lies within the boundaries of the screen, the cursor moves to 
that position; the data on the screen does not move. 

• If the specified cursor relative row precedes the top line currently visible on the screen, the 
cursor moves to the specified column in the top row of the screen; the data then rolls down 
until the specified row appears in the top line of the screen. 

• If the specified cursor relative row precedes the bottom line currently visible on the screen, the 
cursor moves to the specified column in the bottom row of the screen; the data then rolls up 
until the specified row appears in the bottom line of the screen. 
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If you specify only a <column number>, the cursor remains in the current row. Similarly, if you 
specify only a <row number>, the cursor remains in the current column. 

Example 

To position the cursor (rolling the data if necessary) at the character residing 15 columns to the right 
and 25 rows above the current cursor position (within display memory), use the escape sequence: 

\E&:a+15c-25R 

Combining Absolute and Relative Addressing 

You may use a combination of screen relative, absolute and cursor relative addressing within a 
single escape sequence. 

For example, to move the cursor (and roll the text if necessary) so that it is positioned at the 
character residing in the 70th column of the 18th row below the current cursor position, use the 
escape sequence: 

\E&:aG9c + 18R 

Similarly, to move the cursor (and roll the text up or down if necessary) so that it is positioned at 
the character residing in the 10th column of absolute row 48 in display memory, use the escape 
sequence: 

\Ea:a0c47R 

Display Enhancements 

The terminal includes as a standard feature the following display enhancement capabilities: 

• Inverse Video - black characters are displayed against a white background. 

• Underline Video - characters are underscored. 

• Blink Video - characters blink on and off. 


Note 

The half bright display enhancement is not implemented on this termin¬ 
al. When the half bright enhancement is selected on the HP 9000 
Model 520 with a black-and-white display, it is ignored. Selecting the 
half bright enhancement on the HP 9000 Model 520 with a color 
display causes the terminal to select pen 3. (See the section “Accessing 
Color” later in this article). 


The display enhancements are used on a field basis. The field cannot span more than one line. The 
field scrolls with display memory. Overwriting a displayable character in a field preserves the display 
enhancement. The enhancements may be used separately or in any combination. When used, they 
cause control bits to be set within display memory. 

From a program or from the keyboard, you enable and disable the various video enhancements by 
embedding escape sequences within the data. The general form of the escape sequence is: 

\E&d<enhancement code> 

where enhancement code is one of the uppercase letters A through Q specifying the desired 
enhancement(s) or an @ to specify end of enhancement: 
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Enhancement Character 



@ 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

Half-Bright 









X 

X 

X 

X 

X 

X 

X 

X 

Underline 





X 

X 

X 

X 





X 

X 

X 

X 

Inverse Video 



X 

X 



X 

X 



X 

X 


i 

X 

X 

Blinking 


X 


X 


X 


X 


X 


X 


X 


X 

End Enhancement 

X 

















Note that the escape sequence for “end enhancement” (\E&d@) or the escape sequence for 
another video enhancement, ends the previous enhancement. 


Raster Control 

The terminal provides the ability to enable and disable both its alphanumeric display and its graphic 
display. The escape sequences for these capabilities are: 

\E*dc - Turn on graphics display; enable writing to the graphics display. 

\E*dd - Turn off graphics display; disable writing to the graphics display. 

\E*de - Turn on the alphanumeric display; enable writing to the alphanumeric display. 

\E*df - Turn off the alphanumeric display; disable writing to the alphanumeric display. 

Whether used individually or in combination, the last character of the escape sequence must be 
uppercase. For example, to turn off the graphics display, use the escape sequence \E*dD. When 
these sequences are combined, an uppercase specifier must terminate the sequence. To turn on the 
graphics display and turns off the alphanumeric display, use the escape sequence \E*dcF. 

Accessing Color 

If your Model 520 computer is equipped with a color display, you may access its color capabilities 
from HP-UX. First, you need to understand some simple terms. 

Color pair - two colors which define the foreground color (color of the characters) and the 
background color, respectively. At least one color of the color pair must be black; displaying color 
on color is not possible. A total of 15 color pairs are possible, but only eight can be displayed at any 
one time. 
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Pen # - one of eight predefined color pairs. Pen 0 through pen 7 are initially defined as follows 
(re-defining a color pair is described later): 


Pen # 

foreground 

color 

background 

color 

0 

white 

black 

1 

red 

black 

2 

green 

black 

3 

yellow 

black 

4 

blue 

black 

5 

magenta 

black 

6 

cyan 

black 

7 

black 

yellow 


Pen #0 is the default pen selected by the terminal when writing to the display. 

Pen #7 is always used for displaying the softkey labels. 

Selecting a Pen (Color Pair) 

By using an escape sequence, you can select a pen number other than pen #0 when writing to the 
display. Like other display enhancements, pen selection is used on a field basis. The field cannot 
span more than one line. That is, the pen selection is only active until a new-line character is 
encountered; then the default pen is re-selected. The escape sequence for selecting a pen is: 
\E&v n<parameter> 

where n is the pen number you wish to use, and <parameter> is a single character that specifies 
what action you want to take. To select a pre-defined pen number, the necessary <parameter> is 
s. If n > 7, HP-UX performs the calculation (n Modulo 8) on the supplied value to determine the 
actual pen number. Thus, 

\E&v 4S 

selects the pre-defined pen number 4. Note that s is capitalized in the preceding escape sequence. 
This is because escape sequences are terminated by a capital letter. Thus, the last character of any 
escape sequence mustbe uppercase. However, if a parameter is not the last character of the escape 
sequence, it may appear in lower-case. 

Changing Pen Definitions 

You may change the pre-defined color pair for any of the eight existing display pens. The three 
primary colors (red, green and blue) are used in various combinations to achieve the desired color. 

The combinations of red, green, and blue that define foreground and background colors can be 
specified in two notations. The first is RGB (Red-Green-Blue), and the second is HSL (Hue- 
Saturation-Luminosity). The notation must be selected before you can redefine pens (if no notation 
type is specified, the “terminal” uses the last notation specified, or RGB notation at power-up). To 
select a notation type, use the \E&v escape sequence used above: 

\E&v n<parameter> 

where n is 0 (for RGB) or 1 (for HSL), and <parameter> is the letter m. Thus, the sequence 
\E&v IM 

selects HSL notation. It does nothing more. 
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To specify the quantity of red (hue), green (saturation), and blue (luminosity) to appear in your 
background and foreground colors, the a, b, c, x, y, and z parameters are used. These parameters 
have the following meanings: 

a specifies the amount of red (hue) used in the foreground, 
b specifies the amount of green (saturation) used in the foreground, 
c specifies the amount of blue (luminosity) used in the foreground. 

X specifies the amount of red (hue) used in the background, 
y specifies the amount of green (saturation) used in the background, 
z specifies the amount of blue (luminosity) used in the background. 


Each a, b, c, x, y, and z parameter specified is preceded by a number in the range 0 through 1, in 
increments of 0.01. The following table gives the values needed to define the eight principle colors: 


R 

G 

B 

Color 

H 

S 

L 

0 

0 

0 

Black 

X 

X 

0 

0 

0 

1 

Blue 

0.66 

1 

1 

0 

1 

0 

Green 

0.33 

1 

1 

0 

1 

1 

Cyan 

0.50 

1 

1 

1 

0 

0 

Red 

1 

1 

1 

1 

0 

1 

Magenta 

0.83 

1 

1 

1 

1 

0 

Yellow 

0.16 

1 

1 

1 

1 

1 

White 

X 

0 

1 


(Note that X’s in the above table represent “don’t care” situations.) 

One final parameter, i, is needed. It is used to assign a pen number to the newly-defined color pair. 
Thus, the escape sequence for changing a color pair definition is: 

\E&v <0ll>m na nb nc nx ny nz <pen#>I 

where either a 0 or a 1 precedes the m parameter (selecting either RGB or HSL notation, respec¬ 
tively), and n is one of the legal values from the table above. <pen#> is an integer in the range 0 - 
7 which, when combined with the i parameter, defines that pen number to be the color pair 
specified by the preceding a, b, c, x, y, and z parameters. Omitting any a, b, c, x, y, or z parameter 
causes a value of 0 to be assigned to the omitted parameter by default. 
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Examples 

\E&v Om la Ob Oc Ox ly Oz 51 

This example re-defines pen 5 to specify red characters on a green background. (Note that the 
Model 520 will ignore the green background specification and assign a black one instead.) This 
example is equivalent to 

\E&v Om la ly 51 

since omitted parameters (a, b, c, x, y, z) are given default values of 0. 

\E&v Im .66a lb Ic 3i Om Ic lx ly 61 

This example re-defines pen 3 to specify blue characters on a black background (HSL notation), 
and pen 6 to specify blue characters on a yellow background (RGB notation). This example 
illustrates how multiple pens can be defined on a single line using different notations. (Again, note 
that the Model 520 will reject the background specification of pen 6, and will use black instead.) 

\E&v Om ly Iz la Ic 41 

This example re-defines pen 4 to specify a cyan background with magenta characters. This exam¬ 
ple shows how background and foreground specifications can be reversed. The Model 520 will 
accept the magenta foreground, but will reject the cyan background; black will be used instead. 

If the foreground and background colors are both non-black, the foreground color will be used, and 
the background color will be black, regardless of the order in which the parameters are specified. 

\E&v 51 

This example re-defines pen 5 to specify a black foreground and a black background, using the 
previous notation type. 


Note 

Supplying neither a foreground nor a background color when defining a 
color pair causes both the foreground and background to be black. This 
is like typing on a typewriter without paper or ribbon; you can’t see 
what is written. 
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Controlling Configuration and Status 

The terminal provides additional escape sequences for managing its configuration and its status. 


Re-configuring the Terminal 

The terminal allows you to reset a few of its configuration parameters via escape sequences. These 
parameters and their escape sequences are: 


Function 

Escape 

Sequence 

Description 

Auto Line 

Feed Mode 

\E&k nA 

When n is 0, auto line feed mode is off. When n is 1, auto line feed 
mode is on. Default = OFF. 

Local Echo 

\E&k nL 

Characters entered through the keyboard are displayed on the 
screen and transmitted to the computer when n = 1. When n = 0, 
characters entered through the keyboard are transmitted to the 
computer only; if they are to appear on the screen, the computer 
must “echo” them back to the terminal. Default = OFF. 

Remote Mode 

\E&k nR 

When n is 0, the remote mode is off. When n is 1, the remote mode 
is on. Default = ON. 

Caps Mode 

\E&k nP 

When caps mode is enabled, all unshifted alphabetic keys generate 
uppercase letters and all shifted alphabetic keys generate lowercase 
letters. This mode is used primarily as a typing convenience and 
affects only the 26 alphabetic keys. 

When n = 1, the caps mode is enabled. When n = 0, the caps 
mode is disabled. Default == OFF. 

From the keyboard, you enable and disable caps mode using the 
( CAPS 1 key. This key alternately enables and disables caps mode. 

Transmit Function 
(STRAP A) 

\E&s <x>A 

This escape sequence specifes whether or not escape code se¬ 
quences are both executed at the terminal and transmitted to HP- 
UX. 

When X = 1, the escape code sequences generated by control keys 
such as (roll t) and (ROLL i) are transmitted to HP-UX. If local 
echo is ON, the function is also performed locally. 

When X = 0, the escape sequences for the major function keys are 
executed locally, but are not transmitted to HP-UX. The default is 

X = 0. 

Enable End Of Line 
Wrap (STRAP C) 

\E&s <x>C 

This field specifies whether or not the end-of-line wrap is inhibited. 
When X = 0 and the cursor reaches the right margin, it automati¬ 
cally moves to the left margin in the next lower line (a local carriage 
return and line feed are generated). 

When X = 1 and the cursor reaches the right margin, it remains in 
that screen column until an explicit carriage return or other cursor 
movement function is performed (succeeding characters overwrite 
the existing character in that screen column). 

Default = OFF. 
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Sending Terminal Status 

Terminal status is made up of 14 status bytes (bytes 0 through 13) containing information such as 
display memory size, switch settings, configuration menu settings, and terminal errors. There are 
two terminal status requests: primary and secondary. Each returns a set of seven status bytes. 

Primary Terminal Status 

You can request the first set of terminal status bytes (bytes 0 through 6) by issuing the following 
escape sequence: 

\E- 

The terminal responds with an \E\, and seven status bytes followed by a terminator (a carriage- 
return character). A typical primary terminal status request and response is shown in the following 
illustration. 


COMPUTER TERMINAL 



BYTE ASCII 

0 4 

1 0 


2 < 

3 8 


BINARY STATUS 

0011 0100 

'-4K bytes of display memory (2 pages of 24 lines) 

0011 0000-Function key transmission disabled 

^-Cursor wraparound disabled 


Configuration 
Straps A-H 


0011 1100 

0011 1000 

^-Auto line feed disabled 

-Terminal sends secondary status 


4 0 

5 2 

6 0 


0011 0000 

0011 0010 

L 

0011 0000 


Last Self-Test ok 


Primary Terminal Status Example 
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PRIMARY STATUS BYTES 


BYTE 0 DISPLAY MEMORY SIZE 


BYTE 3 LATCHING KEYS 


_8_ 1 __ 6 5 4 3 2 1 

0 0 1 1 0 0 1 0 

I-1K bytes 

-2K bytes 

-4K bytes 

-8K bytes 

This byte specifies the amount of display memory available in the terminal, 
(roughly 2K per page) 


e 


e 

5 


3 

2 

1 

7 ^ 

0 

1 

1 

1 

1/0 

1/0 

0 



0 = no auto LF 


CAPS LOCK Key 
dlways 0 

BLOCK MODE Key 
1 = block mode 
0 = character mode 


BYTE 1 CONFIGURATION STRAPS A-D BYTE 4 TRANSFER PENDING FLAGS 


3 

7 

e 

5 

4 

3 

2 

1 

0 

0 

1 

1 

0 

1/0 

0 

1/0 


strap D — 
Page Line 
alv/ays 0 


^-Strap A 

(Function Key Transmission) 
1 =yes (Transmitted) 

0 = no (Not transmitted) 


Strap C-1 

(Inhibit End-of-Line Wraparound) 

1 yes (Enabled) 

0 • no (Disabled) 


Strap B 

(Space Overwrite Latch) 
always 0 


8 

7 

71 

5 

4 

3 

2 

1 

0 

0 

1 

1 

0 

0 

0 

0 


Secondary Status Pending 
always 0 


Cursor Sense Pending 
always 0 


ENTER Key Pending 
always 0 


Function Key Pending 
always 0 


BYTE 2 CONFIGURATION STRAPS E-H BYTE 5 ERROR FLAGS 


3 

7 

6 

5 


3 

3 

1 

0 

0 

1 

1 

1 

1 

0 

0 


strap H 

always 1 


^-Strap E 

always 0 


8 

V 

6 

5 

[I 

3 

2 

1 

0 

0 

1 

1 

0 

0 

1 

0 


DataComm 
always 0 


Device Error . 

(Integral Printer Error) 
always 0 


Strap G 


Strap F 


always 1 


always 0 


Self-Test 
always 1 


BYTE 6 DEVICE TRANSFER PENDING FLAGS 


8 

7 

6 

0 

4 

3 

2 

1 

0 

0 

1 

1 

0 

0 

0 

0 


L— Device Status Pending 
always 0 

. Device Operation Status 

Pending 
always 0 

(tracks “S", “F", or “U " completion codes associated with ^c&p device 
control sequences.) 
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Secondary Terminal Status 

You can request the second set of terminal status bytes (bytes 7 through 13) by issuing the 
following escape sequence: 


The terminal responds with an \ E 1 , and seven status bytes followed by a terminator (a carriage- 
return character). A typical secondary terminal status request and response is shown in the follow¬ 
ing illustration. 


COMPUTER 


TERMINAL 



BYTE 

ASCII 

BINARY 

STATUS 

7 

0 

0011 0000 


8 

4 

0011 0101 

1 

-Terminal identifies self 

9 

0 

0011 0000 


10 

0 

0011 0000 


11 

0 

0011 0000 


12 

0 

0011 0000 


13 

0 

0011 0000 



Secondary Terminal Status Example 
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BYTE? 


Buffer Memory 
(always zero) 


BYTE 10 


KEYBOARD INTERFACE KEYS ( 


8 

7 ] 

6 

5 

4 

3 

]] 

1 

0 

0 

1 

1 

0 

0 

1 

0 



bytes 

bytes 

bytes 

bytes 



7 

6 

5 

4 

3 

2 

1 

0 

0 

1 

1 

0 

0 

0 

0 


Switch R 
always 0 


L 


Switch N Printer (Escape 
Code Transfer) 
always 0 


Memory installed in addition to display memory that is available for use as 
data buffers. Note that the HP 9000 Model 20 terminals always return a 0 value. 


•- Switch P Compatibility 

Mode (Scaled) 
always 0 


BYTE 8 TERMINAL FIRMWARE CONFIGURATION 


8 

7 

6 

5 

4 

3 

2 

1 

0 

0 

1 

1 

0 

1 

0 

0 


0 = Non-programmable 

terminal - 

1 =Terminal- 

identifies 

self 


always 0 

• 1 = I/O firmware installed, integral 
printer present 
0 = No APL Firmfare 


Switch Q Compatibility 
Mode (Unsealed) 
always 0 


Straps N-R do not apply 


BYTE 11 CONFIGURATION STRAPS S-V 
(always zero) 


APL Firmware does not apply. 

BYTE 9 CONFIGURATION STRAPS J-M 
(always zero) 


_8_7_6_5_4_^ 

0 0 110 0 


2 1 
0 0 



0 = no (Allow test) 


Strap J (Auto Terminate) 

1 =yes (Enabled) 

0 = no (Disabled) 

Strap K (Clear Terminator) 
1 =yes (Enabled) 

0 = no (Disabled) 


Straps J-M do not apply to the terminal. 


8 

7 1 

6 

5 

4 

3 

2 

1 

0 

0 

1 

1 

0 

0 

0 

0 



Straps S-V do not apply to the terminal. 


BYTE 12 


CONFIGURATION STRAPS W-Z 
(always zero) 


Strap Z - 


Strap Y - 


- Strap W (Data Comm Test 
1 =yes (Inhibit) 

0 = no (Allow) 

- Strap X 


Straps X, X, Y, and Z do not apply to the terminal. 


BYTE 13 MEMORY LOCK MODE 
(always zero) 


8 

7 

6 

5 

4 

3 

2 

1 

0 

0 

1 

1 

0 

0 

0 

0 
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HP 98700H Graphics Display 
as a “Terminal” 


The HP 98700H Graphics Display Station can be used as a standalone computer, as a 
terminal to other computers, or as system console to an HP 9000 Model 550 running 
HP-UX. This article describes the HP 98700H as a terminal and as system console for 
the Series 550. It also discusses the methods of accessing the “terminal’s” features: from 
the keyboard and from a program or command (via escape sequences). 

The software that makes the HP 98700H appear as a system console is the ITE (Internal 
Terminal Emulator). The ITE consists of “device driver” code contained in the HP- 
UX kernel. See the section on “ITE and the HP 98700H” later in this article for more 
information. 

The system console is the terminal to which HP-UX sends system loader messages and 
soft system error messages. Like other terminals on an HP-UX system, it is also used for 
general system access (such as logging in, running programs, and entering data). The 
system console: 

• must not be connected via a modem. 

• must have a device file named /dev/console. 

Each HP-UX system must have a system console. When HP-UX is run on the HP 98700H, 
the computer’s keyboard and display act as the system console. 

The display portion of the “terminal” consists of a display screen and display memory. 
The display cursor (an inverse video square on the screen) indicates where the next 
character entered appears. As you enter characters, each is displayed at the cursor 
position, the ASCII code for the character is recorded at the associated position in 
display memory, and the cursor moves to the next character position on the screen. As 
the screen becomes full, newly entered data causes existing lines to be forced off the 
screen. Data lines forced off the screen are still maintained in display memory and can 
subsequently be moved back onto the screen. The size of display memory is determined 
by the HP-UX configuration (see section on “Memory Addressing Scheme” later in this 
article). Once the display memory is full, additional data entered causes the older data 
in display memory to be lost. 
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Throughout this article, the sequence \E represents the escape character. Supplying 
an invalid escape sequence causes that sequence to be ignored. Escape sequences with 
optional or required parameters (referred to as “parameterized escape sequences”) must 
be terminated by an upper-case character before the sequence is implemented. 


The Keyboard 

The keyboard is divided into major functional groups: the alphanumeric group, the 
numeric pad group, the disply control group, the edit group, and the function group. 
Each function group is discussed in the sections below, with an emphasis on features and 
their access. 


Alphanumeric Group 

This group of keys is similar to a standard typewriter keyboard and consists of the 
alphabetic, numeric, and symbol keys. Included are lower and upper case alphabetic 
characters, ASCII control codes, punctuation characters, and some commercial symbols. 


Numeric Pad Group 

The numeric group of keys is located to the right of the alphanumeric keys. The layout 
of the numeric key pad is similar to that of a standard office calculator. These keys are 
convenient for high-speed entry of large quantities of numeric data. 


Display Control Group 

The display control group consists of the keys that control the location of the cursor on 
the display. Each display control key and its function is described in the sections that 
follow. The escape code for accessing each display control feature is provided with each 
display control key. Some display control features can only be accessed via an escape 
sequence; no key is associated with the feature. The escape codes for such features are 
provided in the sections that follow. 
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Cursor Control 

Several keys exist on the keyboard for changing the location of the cursor. Table 1 
describes the keys, their associated escape sequence, and their function. 


Table 1. Cursor Control Keys 


Key 

Escape 

Sequence 

Feature 


\EA 

Move the cursor up one row in the current column position. Holding 
the key down causes the cursor to move continuously, row by row, 
until the key is released. When the cursor is in the top row of the 
screen, moving the cursor up actually moves the cursor to the same 
column position in the bottom row of the screen. 

ffl 

\EB 

Move the cursor down one row in the current column position. Holding 
the key down causes the cursor to move continuously, row by row, 
until the key is released. When the cursor is in the bottom row of 
the screen, moving the cursor down actually moves the cursor to the 
same column position in the top row of the screen. 

► 

\EC 

Move the cursor right one position in the current line; if the current 
position is the right margin, the cursor is moved to the left margin 
of the next line. Holding the key down causes the cursor to move 
continuously, column by column, until the key is released. 

a 

\ED 

Move the cursor left one position in the current line; if the current 
position is the left margin, the cursor is moved to the right margin 
of the previous line. Holding the key down causes the cursor to move 
continuously, column by column, until the key is released. 

E 

\EH or \Eh 

Home up: moves the cursor to the left margin in the top row of the 
screen and rolls the text in display memory down as far as possible 
so that the first line in display memory appears in the top row of the 
screen. 

Shift 

\EF 

Home down: moves the cursor to the left margin in the bottom line of 
the screen and rolls the text in display memory up as far as necessary 
so that the last ine in display memory appears immediately above the 
cursor position. 

none 

\EG 

Move the cursor to the left margin. 
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Table 1. Cursor Control Keys (continued) 



Escape 

Sequence 

Feature 

\EI 

Move the cursor forward to the next tab stop. 

\Ei 

Move the cursor backwards to the previous tab stop. 

\ES 

Roll the text in display memory up one row on the screen. The 
top row rolls off the screen, the remaining data rolls up one line on 
the screen, and a new line of data rolls from display memory into 
the bottom line of the screen. When the key is held down, the text 
continues to roll upward until the key is released or until the final 
line of data in display memory appears in the top row of the screen. 
In the latter case, pressing or continuing to press down the key has 
no further effect. The roll up and roll down functions are shown in 
the illustrations at the end of this section. 

\ET 

Roll the text in display memory down one row on the screen. The 
bottom row rolls off the screen, the remaining data rolls down one 
line on the screen, and a new line of data rolls from the display 
memory into the top line of the screen. When the key is held down, 
the text continues to roll down until the key is released or until the 
first line of data in display memory appears in the top row of the 
screen. In the latter case, pressing or continuing to press down the 
key has no further effect. The roll up and roll down functions are 
shown in the illustrations at the end of this section. 

\EU 

Roll the text in display memory up so that the next page (see the 
explanation below) of data replaces the current page on the screen. 
If the key is held down, the operation is repeated until the key is 
released or until the final line in display memory appears in the top 
line of the screen. In the latter case, pressing or continuing to hold 
down the key has no further effect. 

The cursor is placed at the left margin, at the top row of the display. 

\EV 

Roll the text in display memory down so that the previous page 
(see the explanation below) of data replaces the current page on the 
screen. If the key is held down, the operation is repeated until the 
key is released or until the first line in display memory appears in 
the top line of the screen. In the latter case, pressing or continuing 
to hold down the key has no further effect. 

The cursor is placed at the left margin, at the top row of the display. 
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The data in display memory can be accessed (displayed on the screen) in blocks that 
are known as “pages”. A page consists of 46 lines of data. The current page is that 
sequence of lines which appears on the screen at any given time. The previous page is 
the preceding 46 lines in display memory. The next page is the succeeding 46 lines in 
display memory. This concept, along with the concept of rolling data through the display 
screen and memory, are shown in the following illustrations. 


Roll Up 


Roll Down 


Figure 1. The “Roll” Data Functions 


PREVIOUS PAGE 
46 UNES 


CURRENT PAGE 
46 UNES 


TOTAL ACCESSIBLE MEMORY 
IS 92 UNES, 128 CHAR/UNE, 

BY DEFAULT. 

Figure 2: Previous Page and Next Page Concepts 
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Edit Group 

The edit group consists of the keys that allow you to modify the data presented on 
the screen. Currently, however, the edited data cannot be read back by the system. 
Typically, these features are used to modify data presented by programs. For example, 
the vi text editor program uses these features. 
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You can edit data on the screen by simply overstriking the old data. In addition, the 
edit keys and escape sequences shown in Table 2 may be used. 

Table 2. Edit Keys 

Escape 

Key Sequence Function 

Clear display| \EJ Removes from display memory all characters from the current 

location of the cursor to the end of display memory. 

Clear line \EK Removes from display memory all characters from the current 

location of the cursor to the end of the current line. 

Insert line \EL The text line containing the cursor and all text lines below it 

roll downward one line, a blank line is inserted in the screen row 
containing the cursor, and the cursor moves to the left margin of 
the blank line. Holding the key down causes the operation to be 
repeated until the key is released. 

Delete line \EM The text line containing the cursor is deleted from display mem¬ 

ory, all text lines below it roll upward one row, and the cursor 
moves to the left margin. Holding the key down causes the op¬ 
eration to be repeated until the key is released or until there are 
no subsequent lines of text remaining in display memory. In the 
latter case, pressing or continuing to hold down this key has no 
further effect. 

Delete char| \EP The cursor remains stationary while the character at the current 

cursor location is deleted. All characters between the cursor and 
the right margin move left one column and a blank moves into 
the line at the right margin. 

This function is meant to be used within that portion of the 
screen delineated by the left and right margins. If the cursor 
is positioned to the left of the left margin, the delete character 
function works as previously described. If the cursor is positioned 
beyond the right margin, the delete character function affects 
those characters from the current cursor position through the 
right boundary of the screen. 

If the key is held down, the terminal continues to delete characters 
until either the key is released or no characters remain between 
the cursor position and the right margin. In the latter case, 
pressing or continuing to hold down this key has no further effect. 

Insert char \EQ Turn on the insert character mode (see the description that 

follows). 

Insert char \ER Turn off the insert character mode (see the description that 

follows). 
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Insert Character Mode 

When the “insert character” editing mode is enabled, characters entered through the 
keyboard or received from the computer are inserted into display memory at the cursor 
position. Each time a character is inserted, the cursor and all characters from the current 
cursor position through the right margin move one column to the right. Characters that 
are forced past the right margin are lost. When the cursor reaches the right margin, it 
moves to the left margin in the next lower line and the insert character function continues 
from that point. 


The edit function is meant to be used within that portion of the screen delineated by the 
left and right margins. If the cursor is positioned to the left of the left margin, the insert 
character function works as previously described. If the cursor is positioned beyond the 
right margin, however, the insert character function affects those characters between the 
current cursor position and the right boundary of the screen. In such a case, when the 
cursor reaches the right boundary of the screen, it moves to the left margin in the next 
lower line and the insert character function continues from that point as described in the 
previous paragraph. 


When the insert character mode is enabled (and softkey labels are displayed), the char¬ 
acters IC are displayed between the fourth and fifth function key labels. These characters 
are displayed to remind you that you are in the insert character mode. 


Function Key Group 

Across the top of the keyboard are 10 keys labeled 
through 


fl 


through 


f4 


Menui 


f8 


The functions performed by the function keys (fl through 


dynamically as you use the terminal but are basically determined by the 


User 


f5 


f8 


) change 


Menu 


and 


User 


keys. At any given time the applicable function labels for these keys appear across the 
bottom of the display screen. 


The following table gives the escape sequences to enable/disable some of the function 
keys and the user-defined keys: 


Table 3. Function Key Enable/Disable 
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SYSTEM 

The “SYSTEM” key accesses general terminal control functions. When you press the 
“SYSTEM” key the eight function keys are redefined to two functional keys: “mar¬ 
gins/tabs” (f2) and “modes” (f4). Lower case letters indicate that further menus are 
available; upper case letters describe functions to be performed. Pressing one of these 2 
keys causes another menu to be displayed as described below. The other 6 function keys 
have no effect. 

margins/tabs - When the “MARGINS/TABS” function key is pressed, the eight function 
keys become general control keys that you use for setting and clearing margins and tabs 
from the keyboard. Pressing one of the defined keys causes the terminal to issue the 
appropriate escape sequence for the function selected. These escape sequences and their 
function are discussed later. 


Note that the “MARGINS/TABS” function keys only send their associated escape se¬ 
quences to HP-UX when display functions are enabled and when the A Strap is set 
(discussed later in this article). If these conditions are not met, the escape sequence is 
executed locally but is not sent to HP-UX. 

• Setting and Clearing Margins 

You can redefine the left and/or right margin. These margins affect the cursor 
positioning for certain functions (such as carriage-return, home up, home down, 
etc.) and establish operational bounds for the insert character and delete character 
functions. In addition, the left margin is always an implicit tab stop. Data to the 
left of the left margin or to the right of the right margin is still accessible. 


When you are entering data through the keyboard and the cursor reaches the right 
margin, it automatically moves to the left margin in the next lower line. When you 
the cursor moves to the left margin in the current line if auto line 


Return 


press 

feed mode is disabled or to the left margin in the next lower line if auto line feed 
mode is enabled. 


Margins can be set with the function keys or with the following escape sequences: 

\E4 - set the left margin at the current cursor location. 

\E5 - set the right margin at the current cursor location. 

\E9 - clear both margins; by default the left margin becomes 1, the 
right margin becomes 128. 

Attempting to set the left margin to the right of the right margin (or the right 
margin to the left of the left margin) causes the new margin to be rejected; the 
system beeps to notify you that the new margin was not accepted. 
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• Setting and Clearing Tab Stops 


Some of the eight function keys accessed with the “SYSTEM” key are used to set 
and clear tab stops. 

Note that the left margin is always an implicit tab stop and cannot be cleared. The 
escape sequences to set and clear tab stops are: 

\E1 - set a tab stop at the current cursor position. 

\E2 - clear a tab stop previously set at the current cursor position. 
\E3 - clear all tab stops currently set. 

Note that these features are available only from softkeys (as are the margin functions 
described above.) 


modes - When you press the “MODES” key f4 the eight function keys are redefined 


Pressing a redefined key allows access to one of the “modes” described in the following 
sections. The labels for the redefined keys are shown below (keys without labels are 
undefined): 


fl 

f2 

f3 

f4 

f5 

CD 

f7 

00 

'H 




REMOTE 



DISPLAY 

AUTO 




MODE 



FUNCT 

LF* 


You may use these function keys to enable and disable various terminal operating modes. 
Each defined mode selection key alternately enables and disables a particular mode. 
When the mode is enabled, an asterisk (*) appears in the associated key label on the 
screen (for example, auto line feed mode is enabled in the key menu above). 

When the remote mode is enabled and a key is pressed, the terminal transmits the 
associated ASCII code to HP-UX. In local mode (remote mode is disabled), when an 
alphanumeric key is pressed the associated character is displayed at the current cursor 
position on the screen (nothing is transmitted to HP-UX). 
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When the auto line feed mode is enabled, an ASCII line feed control code is automatically 
appended to each ASCII carriage return control code generated through the keyboard. 
ASCII carriage return control codes can be generated through the keyboard in any of 
the following ways: 

• By pressing Return 

• By simultaneously pressing the keys CTRL and | M | 

• By pressing any of the user keys fl through (provided that a carriage-return 
code is included in the particular key definition). See section on “User” keys later 
in this article. 

When the display functions mode is enabled, the terminal operates as follows: 

• In local mode, it displays ASCII Control codes and escape sequences but does not 
execute them. For example, if you press the terminal displays \ED on the 
screen but does not move the cursor one character to the left. 

• In remote mode, it transmits ASCII control codes and escape sequences but does 
not execute them locally. For example, if you press Shift A , the terminal transmits 
\ES but does not perform the “roll up” function. If local echo is enabled (ON) then 
the \ES is also displayed on he screen. Local echo specifies that the character is 
not only transmitted, but displayed on the terminal as well. 
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These same mode selection functions can be accessed via the escape sequences: 


\E&k <x>R - when x is 0, the remote mode is off; when x is 1, the remote 
mode is on. 


\E&k <x>A - when x is 0, auto line feed mode is off; when x is 1, auto line 
feed mode is on. 

\EY - enables display functions; when enabled, all printing and non¬ 

printing characters are displayed. 

\EZ - disables display functions; when disabled, only printing char¬ 

acters are displayed 


MENU 

The “MENU” key is used to turn on and off the label display while in any label menu. 
Pressing the “MENU” key once will turn off the display, pressing it again will return the 
label display to the previous mode. 


NOTE 

While the label display is off the user key definitions are in effect 
regardless of the previous mode. 


Shift 


USER 

When you press the USER key (| 
defined key labels. In the section “User-definable Keys” the function of the user keys 
and the procedure for defining them is described. 


System!) the eight function keys display the user 


User-definable Keys - The eight function keys fl through fsL besides performing the 


terminal control functions described above, can be defined by a program. In this context, 
“defined” means: 


• You can assign to each key a string of ASCII alphanumeric characters and/or control 
codes (such as carriage return or line feed). 

• You can specify each key’s operation attribute: whether its key definition is to be 
executed locally at the terminal, transmitted to the computer, or both. 

• You can assign to each key an alphanumeric label (up to 16 characters) which, in 
user keys mode (when the “USER” key is pressed), is displayed across the bottom 
of the screen. 
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The definition of each user key may contain up to 80 characters (alphanumeric character, 
ASCII control characters, and explicit escape sequence characters). 

To define a user-definable key, enter the escape sequence: 

\E&f <attribute><key><label lengthxstring length><label><string> 

Where the fields are defined as follows: 

<attribute> is a two-character combination from the list Oa, la, or 2a. The default value 
for <attribute> is Oa. The attribute character specifies whether the definition of the 
particular user key is to be: 

a. Treated in the same manner as the alphanumeric keys (Oa). 

If the terminal is in local mode, the definition of the key is executed locally. If 
the terminal is in remote mode and local echo is disabled (OFF), the definition 
of the key is transmitted to the computer. If the terminal is in remote mode 
and local echo is enabled (ON), the definition of the key is both transmitted 
to the computer and executed locally. 

b. Executed locally only (la). 

c. Transmitted to the computer only (2a). 

When the transmit-only attribute (2a) is designated, the particular user key 
has no effect unless the terminal is in remote mode. A transmit-only user key 
appends the appropriate terminator to the string (either carriage-return or 
carriage-return/line feed, depending on the state of Auto Line Feed). 

<key> is a two-character identifier specifying the key to be defined. The key is specified 
by a value in the range Ik through 8k (Ik is the default). For example, to specify the 
fifth user key, enter 5k for <key>. Note that this differs from the physical key labels on 
the keyboard (they are labeled “fl” through “f8”). 

<label length> is the number of characters in the key label. Acceptable values are in the 
range Od through 16d. Specifying a zero length causes the key label to remain unchanged. 
Od is the default value for the label length. 

<string length> is the length of the string forming the key definition. Acceptable values 
are in the range -IL though 80L; IL is the default. Entering a string length value of zero 
causes the key definition to remain unchanged. A string length value of -1 causes the 
key definition to be erased. 
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<label> is the character sequence for the label. 

<string> is the character sequence for the key definition. 

The <attribute>. <key>, <label length>, and <string length> parameters may appear 
in any sequence but must precede the label and key definition strings. You must use an 
uppercase identifier (A, K, D, or L) for the final parameter and a lowercase identifier (a, 
k, d, or 1) for all preceding parameters. If any of the four fields are omitted, their default 
values are used. At least one of the parameters must be specified because its uppercase 
identifier is needed to terminate the sequence. 

Following the parameters, the first 0 through 16 characters, as designated by <label 
length>, constitute the key’s definition string. The total number of characters (alphanu¬ 
meric data, ASCII control codes such as carriage-return and line feed, and explicit escape 
sequence characters) in the label string can exceed 16, but only the first 16 characters 
are used. The same is true for the destination string; only the first 80 characters are 
used. 

The initial (power-on) definition of the user keys is: 

• all keys are transmit-only (attribute is 2a). 

• the user key labels are f 1 through fS. 

• definitions are \Ep, \Eq, \Er, \Es, \Et, \Eu, \Ev, and \Ew for keys fl through 
f 8 , respectively. These escape sequences have no special meaning to the terminal 
or to HP-UX. 

other Keys 

There are a few keys that do not fall into any particular functional key group. They are 
the ‘‘RESET”, “STOP”, and “PRINT” keys. 

RESET 

After running graphics programs or exiting HP Windows/9000, the HP98700H may be 
left in an incorrect s tate for the IT E to run. The correct state may be restored by pressing 
the “RESET” key ( Shift[Break ). This will reset the color map (see section on “Other 
Features” later in this article), control of the display, and keyboard auto-repeat delay 
and auto-repeat period to the normal ITE state. The contents of the display memory 
are not changed. This key is also useful if the HP 98700H has been powered down and 
you wish to make it useable again. Note that the HP 98700H must have been originally 
powered up with or before the series 500 in order to be used at all. 
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PRINT 

The “PRINT” key (| 


Shift 


Enter 


) is useful with the “RESET” key or by itself. It causes 


the entire contents of the screen to be regenerated, along with the function-key labels, 
to the state last known by the ITE. Nothing else is changed. This key is useful if the 
screen (frame buffer) has been cleared or changed by another process for some reason. 

STOP 

Pressing the “STOP” key will suspend output t o the scree n until it is pressed ag ain. Note 
that this key performs the same function as the CTRL S (suspend output) and CTRL Q 
(resume output) sequence, but no ASCII codes are generated. It may be used along with 
“CTRL-S” and “CTRL-Q”. For example, you may stop the output with 
resume it with the “STOP” key. 


CTRL 


and 


The Display 

The “terminal’s” display has may features of its own, such as video highlights (inverse 
video), raster control, cursor sensing and addressing, and color highlight control. These 
functions are accessed only through escape sequences and are discussed in the sections 
that follow. 

Memory Addressing Scheme 

Display memory positions can be addressed using absolute or relative coordinate values. 
Display memory is made up of 128 columns (0 - 127) and any number of 46 line pages 
(specified by the HP-UX configuration). As shipped to you, the display memory has 
92 lines (0 - 91) of 128 characters (2 screens). The amount of display memory can be 
determined from byte 0 of the primary terminal status (discussed in the section entitled 
“Sending Terminal Status”, later in this article). The types of addressing available are 
absolute (memory relative), screen relative, and cursor relative. 
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Row Addressing 

Figure 3 illustrates the way that the three types of addressing affect row or line numbers. 
The cursor is shown positioned in the fourth row on the screen. Screen row 0 is currently 
at row 6 of display memory. In order to reposition the cursor to the first line of the 
screen the following three destination rows could be used: 


Absolute: row 6 
Screen Relative: row 0 
Cursor Relative: row -3 



First line of screen is: 


(b) 




Figure 3. Row Addressing 


Column Addressing 

Column addressing is accomplished in a manner similar to row addressing. There is no 
difference between screen and cursor relative column addressing. Figure 4 illustrates the 
difference between absolute and relative addressing. The cursor is shown in column 5. 

Whenever the row or column addresses exceed those available, the largest possible value 
is substituted. In screen relative addressing, the cursor cannot be moved to a row position 
that is not currently displayed. For example, in the cursor relative portion of the figure 
above (showing row addressing), a relative row address of -10 would cause the cursor 
to be positioned at the top of the current screen (relative to row -3). Column positions 
are limited to the available screen positions. For example, in the following illustration, 
the absolute column addressing example shows limits of columns 0 and 127, while the 
relative column addressing example shows limits of -5 and 122. The cursor cannot be 
wrapped around from column 0 to 127 by specifying large negative values for relative 
column positions. 
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0 1 2 3 4 5 6 7 8 9 ... 127 






* 

1 

1 




J 


ABSOLUTE 


3 

-2 -1 0 +1 +2 +3 





1 

1 

1 




J 

RELATIVE 


+122 


Figure 4. Column Addressing 


Cursor Sensing 

The current position of the screen cursor can be sensed. The position returned can 
be the absolute position in the display memory or the location relative to the current 
screen position. (Absolute and relative addresses are discussed in the section “Cursor 
Addressing”.) 

Cursor sensing is available only when the “terminal” is in remote mode. 

Absolute Sensing 

When a program sends the escape sequence \Ea to the terminal, the terminal returns to 
the program an escape sequence of the form \E&a xxxc yyyR, where xxx is the absolute 
column number and yyy is the absolute row number of the current cursor position. You 
will later see that this escape sequence is identical to the escape sequence for an absolute 
move of the cursor. 

Relative Sensing 

When a program sends the escape sequence \E‘, the terminal returns to the program 
an escape sequence of the form \E&a xxxcyyyY where xxx is the column number of 
the cursor and yyy is row position of the cursor relative to screen row 0. This escape 
sequence is identical to the escape sequence for a relative move of the cursor (discussed 
later in this article). 
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Cursor Positioning 

The cursor can be positioned directly by giving memory or screen coordinates, or by 
sending the escape codes for any of the keyboard cursor positioning operations. 

Screen Relative Addressing 

To move the cursor to any character position on the screen, use any of the following 
escape sequences: 

\E&a<column number>c<row number>Y 
\E&a<row number>y<column number>C 
\E&a<column number>C 
\E&a<row number>Y 

Where the fields are defined as follows: 

< column number> is a decimal number specifying the screen column to which you wish 
to move the cursor. Zero specifies the leftmost column. 

<row number> is a decimal number specifying the screen row (0 - 45) to which you wsh 
to move the cursor. Zero specifies the top row of the screen; 45 specifies the bottom row. 

When using the escape sequences for screen relative addressing, the data on the screen 
is not affected (the cursor may only be moved around in the 46 rows and 128 columns 
currently displayed, thus data is not scrolled up or down). 

If you specify only <column number>, the cursor remains in the current row. Similarly, 
if you specify only <row number>, the cursor remains in the current column. 

Example 

The following escape sequence moves the cursor to the 20th column of the 7th row on 
the screen: 

\E&a6yl9C 


18 HP 98700H Graphics Display as a “Terminal’ 



Absolute Addressing 

You can specify the location of any character within display memory by supplying ab¬ 
solute row and column coordinates. To move the cursor to another character position 
using absolute addressing, use any of the following escape sequences: 

\E&a<column number>c<row number>R 
\E&a<row number>r<column number>C 
\E&a<column number>C 
\E&a<row number>R 

Where the fields are defined as follows: 

<column number> is a decimal number (0 - 127) specifying the column coordiate (within 
display memory) of the character at which you want the cursor positioned. Zero specifies 
the first (leftmost) column in display memory, 127 the rightmost column. 

<row number> is a decimal number (0 - max) specifying the row coordinate (within 
display memory) of the character at which you want the cursor positioned. Zero specifies 
the first (top) row in display memory, max specifies the last. The value of max is specified 
as: 


[46 (lines/page) X num_page (pages)] - 1 

Where num.page is the number of pages of display memory specified by the system 
configuration. As shipped to you, the configuration dictates that 2 pages of display 
memory be allocated. Thus, the last row that can be addressed is 91. 

When using the above escape sequences, the data visible on the screen rolls up or down 
(if necessary) in order to position the cursor at the specified data character. The cursor 
and data movements occur as follows: 

• If a specified character position lies within the bondaries of the screen, the cursor 
moves to that position; the data on the screen does not move. 

• If the absolute row coordinate is less than that of the top line currently visible on 
the screen, the cursor moves to the specified column in the top row of the screen; 
the data then rolls down until the specified row appears in the top line of the screen. 

• If the absolute row coordinate exceeds that of the bottom line currently visible 
on the screen, the cursor moves to the specified column in the bottom row of the 
screen; the data then rolls up until the specified row appears in the bottom line of 
the screen. 
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Example 

To position the cursor (rolling the data if necessary) at the character residing in the 60th 
column of the 27th row in display memory, the escape sequence is: 

\E&a26r59C 

Cursor Relative Addressing 

You can specify the location of any character within display memory by supplying row 
and column coordinates that are relative to the current cursor position. To move the 
cursor to another character position using cursor relative addressing, use any of the 
following escape sequences: 

\E&a +/- <column number>c +/- <row number>R 
\E&a +/- <row number>r +/- <column number>C 
\E&a +/- <column number>C 
\E&a +/- <row number>R 

Where the fields are defined as follows: 

< column number> is a decimal number specifying the relative column to which you wish 
to move the cursor. A positive number specifies how many columns to the right you wish 
to move the cursor; a negative number specifies how many columns to the left. 

<row number> is a decimal number specifying the relative row to which you wish to 
move the cursor. A positive number specifies how many rows down you wish to move 
the cursor; a negative number specifies how many rows up. 

When using the above escape sequences, the data visible on the screen rolls up or down 
(if necessary) in order to position the cursor at the specified data character. The cursor 
and data movements occur as follows: 

• If a specified character position lies within the boundaries of the screen, the cursor 
moves to that position; the data on the screen does not move. 

• If the specified cursor relative row precedes the top line currently visible on the 
screen, the cursor moves to the specified column in the top row of the screen; the 
data then rolls down until the specified row appears in the top line of the screen. 

• If the specified cursor relative row follows the bottom line currently visible on the 
screen, the cursor moves to the specified column in the bottom row of the screen; 
the data then rolls up until the specified row appears in the bottom line of the 
screen. 

If you specify only a <column number>, the cursor remains in the current row. Similarly, 
if you specify only a <row number>, the cursor remains in the current column. 
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Example 

To position the cursor (rolling the data if necessary) at the character residing 15 columns 
to the right and 25 rows above the current cursor position (within display memory), use 
the escape sequence: 

\E&a+15c-25R 

Combining Absolute and Relative Addressing 

You may use a combination of screen relative, absolute and cursor relative addressing 
within a single escape sequence. 

For example, to move the cursor (and roll the text if necessary) so that it is positioned 
at the character residing in the 70th column of the 18th row below the current cursor 
position, use the escape sequence: 

\E&a69c+18R 

Similarly, to move the cursor (and roll the text up or down if necessary) so that it is 
positioned at the character residing in the 10th column of absolute row 48 in display 
memory, use the escape sequence: 

\E&a9c47R 

Display Enhancements 

The terminal includes as a standard feature the following display enhancement capabili- 
ties: 

• Inverse Video - foreground and background colors are exchanged (see below). 

• Underline Video - Characters are underscored. 


NOTE 

The half bright and blinking display enhancements are not imple¬ 
mented on this terminal. Selecting the half bright enhancement on 
the HP 98700H causes the terminal to select pen 3 (See the sec¬ 
tion “Accessing Color” later in this article). Selecting the blinking 
enhancement has no effect. 


The display enhancements are used on a field basis. The field cannot span more than one 
line. The field scrolls wth display memory. Overwriting a displayable character in a field 
preserves the display enhancement. The enhancements may be used separately or in any 
combination. When used, they cause control bits to be set within display memory. 
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From a program or from the keyboard, you enable and disable the various video enhance¬ 
ments by embedding escape sequences within the data. The general form of the escape 
sequence is: 

\E&d<enhancement code> 

Where enhancement code is one of the uppercase letters A through O specifying the 
desired enhancement(s) or an @ to specify end of enhancement. 


Table 4. Enhancement Character 




A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

Half-Bright 









X 

X 

X 

X 

X 

X 

X 

X 

Underline 





X 

X 

X 

X 





X 

X 

X 

X 

Inverse Video 



X 

X 



X 

X 



X 

X 



X 

X 

Blinking 


X 


X 


X 


X 


X 


X 


X 


X 

End Enhancement 

X 

















Note that the escape sequence for “end enhancement” (E&d@) or the escape sequence for 
another video enhancement, ends the previous enhancement. 

Accessing Color 

Color pair - 

two colors which define the foreground color (color of the characters) and the background 
color, respectively. A total of 64 color pairs are possible but only eight can be displayed 
at any one time. 
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Pen#- 

one of eight predefined color pairs. Pen 0 through pen 7 are initially defined in Table 5 
(re-defining a color pair is described later). 


Table 5. Color Pairs 


Pen # 

Foreground 

Color 

Background 

Color 

0 

white 

black 

1 

red 

black 

2 

green 

black 

3 

yellow 

black 

4 

blue 

black 

5 

magenta 

black 

6 

cyan 

black 

7 

black 

black 


Pen #0 is the default pen selected by the terminal when writing to the display. 

Pen #7 is always used for displaying the softkey labels. 

Selecting a Pen (Color Pair) 

By using an escape sequence, you can select a pen number other than pen #0 when 
writing to the display. Like other display enhancements, pen selection is used on a field 
basis. The field cannot span more than one line. That is, the pen selection is only active 
until a new-line character is encountered; then the default pen is re-selected. The escape 
sequence for selecting a pen is: 

\E&v n<parameter> 

Where n is the pen number you wish to use, and <parameter> is a single character 
that specifies what action you want to take. To select a pre-defined pen number, the 
necessary <parameter> is s. If n >7, HP-UX performs the calculation (n Modulo 8) on 
the supplied value to determine the actual pen number. Thus, 

\E&v 4S 

selects the pre-defined pen number 4. Note that s is capitalized in the preceding escape 
sequence. This is because escape sequences are terminated by a capital letter. Thus, the 
last character of any escape sequence must be uppercase. However, if a parameter is not 
the last character of the escape sequence, it may appear in lower-case. 
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Changing Pen Definitions 

You may change the pre-defined color pair for any of the eight existing display pens. The 
three primary colors (red, green, and blue) are used in various combinations to achieve 
the desired color. 

The combinations of red, green, and blue that define foreground and background colors 
can be specified in two notations. The first is RGB (Red-Green-Blue), and the second 
is HSL (Hue-Saturation-Luminosity). The notation must be selected before you can 
redefine pens (if no notation type is specified, the “terminal” uses the last notation 
specified, or RGB notation at power-up). To select a notation type, use the \E&v escape 
sequence used above: 

\E&v n<parameter> 

Where n is 0 (for RGB) or 1 (for HSL), and <parameter> is the letter m. Thus, the 
sequence 

\E&v IM 

selects HSL notation. It does nothing more. 

To specify the quantity of red (hue), green (saturation), and blue (luminosity) to appear 
in your background and foreground colors, the a, b, c, x, y, and z parameters are used. 
These parameters have the following meanings: 

a specifies the amount of red (hue) used in the foreground 
b specifies the amount of green (saturation) used in the foreground 
c specifies the amount of blue (luminosity) used in the foreground 
X specifies the amount of red (hue) used in the background 
y specifies the amount of green (saturation) used in the background 
z specifies the amount of blue (luminosity) used in the background 
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Each a, b, c, x, y, and z parameter specified is preceded by a number in the range 0 
through 1, in increments of 0.01. Table 6 gives the values needed to define the eight 
principle colors. 


Table 6. Eight Principle Color Values 


R 

G 

B 

Color 

H 

s 

L 

0 

0 

0 

Black 

X 

X 

0 

0 

0 

1 

Blue 

0.66 

1 

1 

0 

1 

0 

Green 

0.33 

1 

1 

0 

1 

1 

Cyan 

0.50 

1 

1 

1 

0 

0 

Red 

1 

1 

1 

1 

0 

1 

Magenta 

0.83 

1 

1 

1 

1 

0 

Yellow 

0.16 

1 

1 

1 

1 

1 

White 

X 

0 

1 


(Note that X’s in the above table represent “don’t care” situations.) 

One final parameter, i, is needed. It is used to assign a pen number to the newly-defined 
color pair. Thus the escape sequence for changing a color pair definition is: 

\E&v <0|l>m na nb nc nx ny nz <pen#>I 

where either a 0 or a 1 precedes the m parameter (selecting either RGB or HSL notation, 
respectively), an n is one of the legal values from the table above. <pen#> is an integer 
in the range 0-7 which, when combined wth the i parameter, defines that pen number to 
be the color pair specified by the preceding a, b, c, x, y, and z parameters. Omitting any 
a, b, c, X, y, or z parameter causes a value of 0 to be assigned to the omitted parameter 
by default. 

Examples 

\E&v Om la Ob Oc Ox ly Oz 51 

This example re-defines pen 5 to specify red characters on a green background. This 
example is equivalent to: 

\E&v Om la ly 51 

since omitted parameters (a, b, c, x, y, z) are given default values of 0. 

\E&v Im .66a lb Ic 3i Om Ic lx ly 61 
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This example re-defines pen 3 to specify blue characters on a black background (HSL 
notation), and pen 6 to specify blue characters on a yellow backgrond (RGB notation). 
This example illustrates how multiple pens can be defined on a single line using different 
notations. 

\E&v Om ly Iz la Ic 41 

This example re-defines pen 4 to specify a cyan background with magenta characters. 
This example shows how background and foreground specifications can be reversed. 

\E&v 51 

This example re-defines pen 5 to specify a black foreground and a black background, 
using the previous notation type. 


NOTE 

Supplying neither a foreground nor a background color when defin¬ 
ing a color pair causes both the foreground and background to be 
black. This is like typing on a typewriter without paper or ribbon; 
you can’t see what is written. 
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Additional Notes About the ITE 
and the HP 98700H 

The following section contains information that is essential if you are using certain fea¬ 
tures of HP-UX, but is not necessary reading for using the HP 98700H as a “normal” 
terminal. 

Color Map 

Features of the ITE deal mainly with lower level hardware control and interaction 
with the Starbase graphics system. A brief explanation of the basic operation of the 
HP 98700H will help clarify these features. 

The HP 98700H is a color-mapped system of up to eight planes. It has internal memory, 
called the frame buffer, which directly controls what is displayed on the color monitor. 
Each pixel (the smallest displayable unit) on the display monitor is controlled by one 
byte of the frame buffer memory. The eight planes correspond to the width (8 bits or 1 
byte) of the frame buffer. 

The color map takes each byte of the frame buffer and from it generates a combination of 
red, green, and blue and sends it to the monitor. Since 1 byte may take on 256 different 
values, there are 256 different colors that may be visible on the screen at any one time. 
Each pixel may be assigned any one of these 256 (including black) colors. Any one of 
over 16 million colors may be generated by the color map, but only 256 are available at 
any one time. 

The ITE uses only 3 of the 8 planes available since only 8 (2^) colors need to be avail¬ 
able for the “terminal”. The other planes are disabled and turned off by the ITE; the 
information in them is not displayed and remains unchanged while the ITE is running. 
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Screen Windowing 

The ITE may be configured to use only the lower part of the display monitor screen and 
not touch the rest. This might be useful when interacting with graphics programs. The 
escape sequence to accomplish this is: 

\E&w2f <starting screen line> U 

where <starting screen line> is the line number (0 through 45) of the screen where you 
want the display to start. If no number is entered, 0 is used as the default, giving a 
full-screen display. The width of the displayed area is not changeable; it is always 128 
characters. Note that the display memory size is not changed by this escape sequence; 
only the effective page (display screen) size is changed. The next-page and previous-page 
keys will work based on this new page size. If a number outside the range of 0 to 45 is 
entered, the entire escape sequence is ignored. 


Interaction with Starbase and HP Windows/9000 

While running HP Windows/9000 the ITE is automatically disabled from receiving any 
keystrokes. After exiting HP Windows/9000 or running graphics programs, the “RE¬ 
SET” and “PRINT” keys may be needed to restore correct operation to the ITE. 

Note that a limited interaction other than screen windowing may be safely accomplished 
with the ITE and the Starbase graphics system. Since the ITE only uses 3 out of the 
possible 8 planes of the frame buffer it is possible for alpha and graphics information 
to coexist independently on the screen. This requires that the color map be set up 
with some care. See the Starbase Device Driver Library, PN98592-90010 and HP-UX 
Reference, VoL4, PN09000-90008, commands inquire_color_table, define_color_tctble and 
inquire_sizes for further information on setting up the color map. 
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Multiple Keyboards 

Multiple keyboards, or HIL devices which look like keyboards, may be connected to the 
HP-HIL and run with the ITE. The data from the keyboards is logically “or”ed together; 
there is no way to distinguish between different keyboards. The effective language of the 
keyboard set is the language of the first keyboard on the loop when the model 550 was 
powered up. 


CAUTION 

Opening driver 43 (the HP98700H HP-HIL cooked keyboard 
driver) directly from a user program is dangerous. It will “steal” 
keystrokes from the ITE. This could cause an inability to exit from 
the program, locking your session up. 


Native Language Support 

The ITE currently has limited support for native languages. 

Character Sets 

Output of the complete ROMANS character set is supported. 

The Katakana (KANA8) character set is not available. 

The extended character set (accessed by the “EXTEND CHAR” key) is not available. 

Native Language Keyboards 

All of the local language keyboards are supported by the ITE with the exception of 
KATAKANA which is supported only in ROMAN mode. Muting, however, is not avail¬ 
able. Typing an umlaut followed by an “a”, for example, will produce the two separate 
characters instead of an “umlaut a” character. 

Other 

Note also that the ITE is always in 8-bit mode; 7-bit substitution is never done. This 
means that 8 bits of character code data are always generated. The istrip option of 
stty(l) may make it appear that only 7-bit data is being generated. 

The keyboard connected to the system self-identifies itself as being a particular language. 
There is no way to change the effective language of a keyboard from the ITE. 


HP 98700H Graphics Display as a “Terminal” 29 



Since the extended character set is not supported, a method of accessing the ASCII 
characters which are often substituted on local language keyboards is needed. This is 
done by shifting the keypad keys as shown in Table 7. 


Table 7. Extended ASCII Characters 


KEYS 

SHIFTED 

KEYS 

NORMAL 

1 

* 

\ 

/ 


+ 

[ 

7 

1 

8 

{ 

9 

} 

ENTER 


4 

# 

5 

~ 

6 



< 

1 

> 

2 


These shifted keypad characters are available on all non-US ASCII, non-Katakana key¬ 
boards. 
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Setting up the HP 98700H as a Terminal 

To set up the HP 98700H as a terminal you must make a device file using mknod and 
modify inittab. 

To make a device file use the command: 
mknod /dev/itel c 29 OxffOlOO 

where /dev/itel is the device file ,c is the mknod option designating /dev/itel as a 
character file, 29 is the driver file (ITE is driver #29), and the 01 portion of the hex 
number corresponds to the slot number of the graphics display buffer card {HP 98288A). 
The graphics display buffer card can be installed in any of slots 04 - 07. The number 
used in the mknod command is the slot# - 4 (00 - 03). Installation of this board must 
be performed by a Hewlett-Packard engineer or a Hewlett-Packard trained Customer 
Engineer. The engineer should refer to HP9050 Hardware Support Document, PN 09050- 
90038. 

Modify inittab as described in the HP-UX Reference section 5 {inittab(5)). 


Controlling Configuration and Status 

The terminal provides additional escape sequences for managing its configuration and its 
status. 

Reconfiguring the Terminal 

The terminal allows you to reset a few of its configuration parameters via escape se¬ 
quences. These parameters and their escape sequences are listed in Table 8. 
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Table 8. Reconfiguration Escape Sequences 


Function 

Escape 

Sequence 

Description 

Auto Line 

Feed Mode 

\E&k nA 

When n is 0, auto line feed mode is off. When n is 1, auto line 
feed mode is on. Default — 0. 

Local Echo 

\E&k nL 

Characters entered through the keyboard are displayed on the 
screen and transmitted to the computer when n = 1. When n 
= 0, characters entered through the keyboard are transmitted 
to the computer only; if they are to appear on the screen, the 
computer must “echo” them back to the terminal. Default = 
0 

Remote Mode 

\E&k nR 

When n is 0, the remote mode is off. When n is 1, the remote 
mode is on. Default = 1. 

Caps Mode 

\E&k nP 

When caps mode is enabled, all unshifted alphabetic keys gen¬ 
erate uppercase letters and all shifted alphabetic keys generate 
lowercase lettes. This mode is used primarily as a typing con¬ 
venience and affects only the 26 alphabetic keys. 

When n = 1, the caps mode is enabled. When n = 0 the caps 
mode is disabled. Default = 0. 

From the keyboard, you enable and disable caps mode using 
the “CAPS” key. This key alternately enables and disables 
caps mode. 

Transmit Function 
(STRAP A) 

\E&s<x>A 

This escape sequence specifies whether or not escape code se¬ 
quences are executed both at the terminal and transmitted to 
HP-UX. 

When X = 1, the escape code sequences generated by control 
keys such as Shift A and jShift yj are transmitted to HP- 
UX. If local echo is ON, the function is also performed locally. 
When X = 0, the escape sequences for the major function keys 
are executed locally, but are not transmitted to HP-UX. The 
default is X = 0. 

Enable End 

Of Line Wrap 
(STRAP C) 

\E&s<x>C 

This field specifies whether or not the end-of-line wrap is in¬ 
hibited. When X = 0 and the cursor reaches the right margin, 
it automatically moves to the left margin in the next lower 
line (a local carriage return and line feed are generated). 
When X = 1 and the cursor reaches the right margin, it re¬ 
mains in that screen column until an explicit carriage return 
or other cursor movement function is performed (succeeding 
characters overwrite the existing character in that screen col¬ 
umn). 

Default: x = 0 


32 HP 98700H Graphics Display as a “Terminar 










Sending Terminal Status 

Terminal status is made up of 14 status bytes (bytes 0 through 13) containing information 
such as display memory size, switch settings, configuration menu settings, and terminal 
errors. There are two terminal status requests: primary and secondary. Each returns a 
set of seven status bytes. 

Primary Terminal Status 

You can request the first set of terminal status bytes (bytes 0 through 6) by issuing the 
following escape sequence: 

\E- 

The terminal responds with an \E\, and seven status bytes followed by a terminator (a 
carriage return character). A typical primary terminal status request and response is 
shown in Figure 5. 


HP 98700H Graphics Display as a “Terminal” 33 






COMPUTER 



TERMINAL 

BYTE 

ASCII 

BINARY 

STATUS 

0 

4 

0011 0100 





1 

-8K bytes of display memory (2 pages of 46 lines) 

1 

0 

0011 0000 - 

1 

-Function key transmission disabled 





1 

-Cursor wraparound disabled 

Configuration 






Straps A-H 

2 

< 

0011 1100 



3 

8 

0011 1 

000 





1_ 

-Auto line feed disabled 





-Terminal sends secondary status 

4 

0 

0011 0000 


5 

2 

0011 0010 





1 

-Last Self-Test ok 

6 

0 

0011 0000 



Figure 5. Primary Terminal Status Example 
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BYTEO 


DISPLAY MEMORY SIZE 


BYTE 3 


LATCHING KEYS 


_8_7_6_5_4_3_2_^ 

0 0 1 1 0 0 1 0 


1K bytes 
2K bytes 
4K bytes 
8K bytes 


This byte specifies the amount of display memory available in the terminal, 

(roughly 4K per page) 


0 0 1 1 1 1/0 1/0 0 


Terminal sends 
secondary status 


J 


CAPS LOCK Key 
always 0 


AUTO LF Key 
1 = auto LF 
0 = no auto LF 


BLOCK MODE Key 
1 = block mode 
0 = character mode 


BYTE 1 CONFIGURATION STRAPS A-D BYTE 4 TRANSFER PENDING FLAGS 


8 7 6 5 4 3 2 1 


0 0 


0 


1/0 0 


1/0 


Page/Line 
always 0 


Strap C- 

(Inhibit End-of-Line Wraparound) 
1 = yes (Enabled) 

0 = no (Disabled) 




Strap A 

(Function Key Transmission) 
1 =yes (Transmitted) 

0 = no (Not transmitted) 

Strap B 

(Space Overwrite Latch) 
always 0 


8 7__ L 

0 0 1 1 0 0 0 0 


Secondary Status Pending 
always 0 


Cursor Sense Pending 
always 0 


ENTER Key Pending 
always 0 


Function Key Pending 
always 0 


BYTE 2 CONFIGURATION STRAPS E-H 


BYTE 5 ERROR FLAGS 


strap H “ 
always 1 




Strap E 
always 0 


8 7 6 5 _^_3 2_J_ 

0 0 1 1 0 0 1 0 


Device Error - 

(Integral Printer Error) 
always 0 


DataComm 
always 0 


Strap G 


Strap F 


always 1 


always 0 


Self-Test 
always 1 


BYTE 6 DEVICE TRANSFER PENDING FLAGS 


_8_7_6_5_4_3_2_1_ 

0 0 1 1 0 0 0 0 

^- Device Status Pending 

always 0 

-Device Operation Status 

Pending 
always 0 


(tracks "S ", "F ”, or '"U" completion codes associated with ^C&p device 
control sequences.) 

Figure 6. Primary Status Bytes 
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Secondary Terminal Status 

You can request the second set of terminal status bytes (bytes 7 through 13) by issuing 
the following escape sequence: 

\E~ 

The terminal responds with an \E|, and seven status bytes followed by a terminator (a 
carriage return character). A typical secondary terminal status request and response is 
shown in Figure 7. 



COMPUTER 



TERMINAL 

BYTE 

ASCII 

BINARY 

STATUS 

7 

0 

0011 0000 


8 

4 

0011 0101 

1 




1 

-Terminal identifies 

9 

0 

0011 0000 


10 

0 

0011 0000 


11 

0 

0011 0000 


12 

0 

0011 0000 


13 

0 

0011 0000 



Figure 7. Secondary Terminal Status Example 
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BYTE? 


Buffer Memory 
(always zero) 


BYTE 10 


KEYBOARD INTERFACE KEYS (N-R) 


8 7 6 5 4 3 2 


0 0 


0 0 1 0 



bytes 

bytes 

bytes 

bytes 


8 7 6 5 4 


3 2 1 


0 0 


0 0 0 0 


Switch R 
always 0 


I— Switch N Printer (Escape 
Code Transfer) 
always 0 


Memory installed In addition to display memory that is available for use as 
data buffers. Note that the HP 9000 Model 20 terminals always return a 0 value. 


I- Switch P Compatibility 

Mode (Scaled) 
always 0 


BYTE 8 TERMINAL FIRMWARE CONFIGURATION 


0= Non-programmable 

terminal - 

1 = Terminal- 

identifies 

self 


always 0 

• 1 = I/O firmware installed, integral 
printer present 
0 = No APL Firmfare 


Switch Q Compatibility 
Mode (Unsealed) 
always 0 


Straps N-R do not apply 


BYTE 11 CONFIGURATION STRAPS S-V 
(always zero) 


APL Firmware does not apply. 


BYTE 9 CONFIGURATION STRAPS J-M 
(always zero) 


Strap M - 


Strap L (Self-Test Inhibit) - 
1 = yes (Inhibit test) 

0 = no (Allow test) 


Strap J (Auto Terminate) 

1 =yes (Enabled) 

0 = no (Disabled) 

- Strap K (Clear Terminator) 
1 =yes (Enabled) 

0 = no (Disabled) 


Straps J-M do not apply to the terminal. 


0 01 1 0 0 0 0 


Strap V - 
Strap U - 


L 


Strap S 
Strap T 


Straps S-V do not apply to the terminal. 


BYTE 12 


CONFIGURATION STRAPS W-Z 
(always zero) 


strap Y - 


Strap W (Data Comm Test) 
1 = yes (Inhibit) 

0 = no (Allow) 

Strap X 


Straps X. X, Y, and Z do not apply to the terminal. 


BYTE 13 MEMORY LOCK MODE 
(always zero) 


8 7 6 5 


3 2 1 


0 0 


0 0 0 0 


Figure 8. Secondary Status Bytes 
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Using Aterm 


The asynchronous terminal emulator (aterm) program, available only on HP 9000 Series 500 HP- 
UX computers, emulates a CRT display terminal while interacting with a remote host computer 
system, whether the host is running HP-UX or some other operating system. While aterm 
can only be activated on a Series 500 computer that is running HP-UX, the host computer 
can use any operating system that is capable of communicating with user terminals through an 
asynchronous (direct or modem) terminal connection. 

Aterm and cu have similarities as well as some differences. While cu is the preferred terminal 
emulator program for most users, there are cases where aterm may be more suitable for certain 
applications. 

Aterm requires a previously prepared configuration file that must be specified when the aterm 
command is invoked from HP-UX. The configuration file specifies the data-communication pa¬ 
rameters (such as baud rate, bits per character, parity, and such) that are to be used while 
passing information between aterm and the remote computer. 


NOTE 

Aterm is available only on Series 500 computers. 


Manual Overview 

This tutorial includes two chapters: 

• Chapter 1 contains an overview of aterm and discusses emulator operation. It is oriented 
toward the needs of typical system users. 

• Chapter 2 provides hardware and software installation information that is generally most 
useful to the System Administrator. 
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Where Do I Start? 


If You Are a User 

If you are a user, and your System Administrator has set up the hardware and software config¬ 
uration on your Series 500 computer, refer to the terminal emulator operation topics discussed 
in the remainder of this chapter. 


If You Are the System Administrator 

If you are System Administrator, you need to perform the asynchronous terminal emulator (aterm 
program) tasks related to hardware and software installation that are explained in Chapter 2, 
Chapter 1 contains some helpful tips for use when troubleshooting erroneous operating results. 
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Asynchronous Terminal Emulator 


Invoking aterm 

The emulator is invoked much like any other HP-UX command. It occupies one executable file, 
normally located in the directory /bin. To run aterm, type: 

aterm cfile 

where, cfile is the name of your previously prepared configuration file. If the configuration file 
name is omitted or cannot be opened or read by the emulator, the emulator aborts and displays 
a diagnostic message. If an improper command or argument is detected in the configuration 
file, the emulator issues a diagnostic message and continues running. If this happens, check the 
running configuration by typing the local command 

RETURN 

to obtain a listing of the parameters used. If you need to change emulator configuration values, 
you can use local commands that are described in the next section. 

If you have enabled modem handshake, the message: 
aterm: waiting for modem connection 

is displayed. If you are originating the call, you have one minute to make a modem connection 
to the host. If the connection is not completed within that time limit, aterm aborts. 

Occasionally, you may be using aterm to respond to incoming calls that connect through an 
auto-answer modem. If so, you must be prepared to recognize the arrival of the incoming call 
(such as listening to an audible ringer). When the call arrives, invoke aterm. If aterm cannot 
successfully complete the connection within one minute, the message: 

aterm: can’t complete modem connection 

is displayed and you must repeat the process to make the connection. If the computer that 
initiated the incoming call has its own time limit for call completion, aterm must also complete 
the connection before that time limit expires or the calling computer may abort the call, causing 
the connection to fail. 

When the emulator has completed initialization and is ready to accept commands or data, the 
emulator displays: 

aterm: connected 
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Using aterm for File Transfers 

To transmit a file (transl in this example) to a remote computer with aterm operating as a non¬ 
interactive background process, use standard shell input-diversion notation as in this example: 

aterm figSOOO <transl & 

Aterm transmits the file transl (which could contain a concatenated series of commands and/or 
data files for the remote computer) to the remote computer, and uses the configuration file 
figSOOO to set up the datacomm link that carries the transmission(s). The amperesand causes 
HP-UX to run aterm as a background process, leaving the keyboard free for other uses while 
aterm is running. 

Note that the redirection from transl is a shell input diversion, not an emulator input diversion 
(emulator input diversions are described in the section, “Local Commands” later in this chapter). 

In the above example, any data sent to standard output appears on your screen. One way 
to suppress this is to specify a shell output diversion that redirects output to a specidied file. 
Diagonostics, while they normally appear on the terminal emulator screen, can be redirected to 
another file or can be included in an output diversion file. 

To divert the error messages to a separate file, use the command: 
aterm cfile > output.file 2>errfile (for Bourne Shell) 

(aterm cfile > output.file) >& errfile (for C Shell) 

This diverts the emulator output to a file named outputjile and any error messages to a file 
named errfile. To include any error messages in the output file, use the command: 

aterm cfile > output^file 2>&1 (for Bourne Shell) 

aterm cfile >& output_file (for C Shell) 
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Local Commands 

Local commands are commands that are interpreted by the terminal emulator without being 
passed on to the host computer. The emulator passes some of these commands to the local 
HP-UX system for execution. Aterm treats any input line that begins with a tilde C) as a 
local command, and interprets it accordingly, whether the input is from the keyboard or from 
a command file. The default local-command escape character is but it can be redefined to a 
different character by changing the local-command escape character definition in the configuration 
file specified when invoking aterm. 

To send a line to the host computer beginning with (or the redefined local-command character), 
begin the line with two local escape characters C'"). The emulator removes one of the characters, 
then sends the rest of the line to the host computer. 

The examples in this chapter are based on the assumtion that the default local-command escape 
character is being used. If you are using an alternate character, substitute the alternate 
character for 

To correct typing errors that occur when entering a local command, use BACK SPACE to relocate 
the cursor, then retype the line, beginning ast the first incorrect character. ESC-M cannot be 
used to clear a line of text. 

Configuration Commands 

Most aterm configuration parameters can be changed to new values without terminating aterm 
or disconnecting the data comm link. The only parameters that cannot be changed while aterm is 
running are device address, host name, modem connection, and switched service. This feature 
is useful if you do not know the exact communication format being used by the host computer. 
Communication parameters such as input and output modes, echo, and terminator sequences 
can be modified at will, and you can see the results of each modification immediately. 

To change configuration while aterm is running, use the local-command escape character followed 
by the aterm configuration escape character, an asterisk (*), and the new configuration command. 
For example, to change the data rate to 9600, type: 

~*dr 9600 RETURN 

If the attempted change is not valid, a diagnostic is displayed. Equivalent configuration commands 
can be placed in a script file if you need to run the emulator as a background process and 
change configuration while aterm is running. Local configuration commands are commonly used 
to change prompt handshake and prompt timeout without program termination. An example is 
provided later in this chapter. 
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The following list shows the recognized configuration command names: 


da Serial device file name (no default); 

hn Name of remote computer system (no default); 

db Number of data bits per character: 5, 6, 7, or 8 (default = 7); 

sb Number of stop bits per character: 1, 1.5, or 2 (default = 1); 

pa Character parity: none (n), odd (o), even (e), zero (0), or one (1) (default = o); 

dr Rate for data sent and received: 50, 75, 110, 134.5, 150, 300, 600, 1200, 

1800, 2400, 3600, 4800, 9600, or 19 200 baud (default = 2400 baud); 

me Modem control: enabled (+) for full-duplex modem, or disabled (—) for full-duplex 

hard-wired connection (default = —); 

ss Switched service: auto-answer (a) or manual originate (o) (default = o); 

ga Gap: number of character transmission times to delay between successive output 

characters; values range from 0 to 254 (default = 0); 

ec Echo: enabled (-f) if the host computer echos characters sent by the emulator, 

disabled (—) otherwise (default = —); 

te Terminal ENQ/ACK: enabled (+) or disabled (—) (default = +); 

he Host ENQ/ACK: enabled (+) or disabled (—) (default = —); 

tx Terminal XON/XOFF: enabled (-H) or disabled (—) (default = —); 

hx Host XON/XOFF: enabled (+) or disabled (—) (default = —); 

im Input mode: block (b), character (c), or line (1) (default = b); 

om Output mode: character (c) or line (1) (default = c); 

ph Prompt handshake: if enabled (-f), the emulator waits for the prompt sequence 

before sending each line of data during an input diversion; if disabled (—), no wait 
is performed (default = —); 

pt Prompt timeout: number of seconds to allow for receipt of a prompt sequence 

during an input diversion; values range from 1 to 600, with 0 disabling the 
timeout altogether (default = 0); 

st Single text terminators: list of characters, any of which terminates a line sent by 

the host computer when the emulator is in input line mode; up to eight characters 
may be specified (default = no characters); 
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dt Double text terminator: a pair of characters which together terminate a line 

sent by the host computer when the emulator is in input line mode (default = 
carriage-return/line-feed); 

ps Prompt sequence: one or two characters which terminate a line sent by the host 

computer when the emulator is in input line mode, and which satisfy the prompt 
handshake if enabled (default = DCl); 

bl Beginning of line: character to be prefixed to each line sent to the host computer 

(default = none); 

el End of line: one or two characters to be postfixed to each line sent to the host 

computer (default = carriage-return); 

es Local command character: character which designates a local command to be 

interpreted by the emulator if it comes at the beginning of a line read from the 
standard input (default = “'). 

Note that aterm does not support block or format modes. 

Emulator Configuration Display 

If you supply a local configuration command without an argument, the emulator displays the 

current configuration. Thus: 

produces a formatted display of the current configuration on the standard output that is similar 

to the following example: 

+-C-O-N-F-I-G-U-R-A-T-I-O-N—D-I-S-P-L-A-Y-+ 

! DEVICE FILE NAME: /dev/asi04 ! 

! HOST SYSTEM NAME: hpSOOO ! 

! DATA RATE: 1200 DATA BITS: 8 STOP BITS: 1 PARITY: ZERO ! 

! TERMINAL ENQ/ACK: ON HOST ENQ/ACK: OFF ! 

! TERMINAL X-ON/X-OFF: PFF HOST X-ON/X-OFF: OFF ! 

! MODEM CONTROLS: NO SWITCHED SERVICE: ORIGINATE ! 

! INPUT MODE: BUFFERED OUTPUT MODE: CHAR GAP: 0 ! 

! HOST ECHO: YES SIGNAL RATE: HIGH ! 

! NO SINGLE TEXT TERMINATOR CHARACTERS ! 

! DOUBLE TEXT TERMINATOR SEQUENCE: < 15> < 12> ! 

! PROMPT CHARACTER: < 21> HANDSHAKE: DISABLED ! 

! PROMPT TIMEOUT: 0 ! 

! NO BEGINNING OF LINE OUTPUT PREFIX ! 

! OUTPUT POSTFIX FOR END OF LINE: < 15> ! 

! LOCAL COMMAND ESCAPE CHARACTER: <176> ! 
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The formatted display information can be diverted from the display to a file or another program 
such as a line-printer spooling program. For example: 

>/dev/lp 

redirects the formatted configuration display to the file /dev/lp, which could be a printer on the 
HP-UX system. 

Emulator Status Display 

The ? emulator configuration command character produces a current emulator status listing. 
Syntax is: 

~? 

As before, the formatted display is sent to standard output, but it can be diverted by redirection 
or to a pipe. Here is an example of part of a typical display produced by the status command: 

+-S-T-A-T-U-S—-D-I-S-P-L-A-Y-+ 

! I 

! VERSION: QA RELEASE X.ll, 8 OCTOBER 1982 ! 

! STANDARD INPUT FROM KEYBOARD ! 

! ! 

+-+ 

Serial Interface Status Display 

To produce an Asynchronous Serial Interface (ASl card) Status listing, use the command: 

V 

Aterm inputs information from the interface status registers on the ASl card, formats it, then 
sends the formatted display to standard output. As with previous displays, the information can 
be redirected to a file or piped to a spooler. This information is useful to service personnel when 
diagnosing emulator malfunctions. Here is a typical example: 

+-A-S-I-—S-T-A-T-U-S-+ 

! SWITCHES: BEH MODE CONTROL: 80H END COUNT: 200 ! 

! ALERTl READ MODE: ENABLED ! 

! STRIPPING; OH HANDSHAKE: IH ENQ/ACK TIMER: 5 ! 

! DATA BITS: 3 STOP BITS: 0 PARITY: 3 ! 

! BAUD RATE: 9 XMSN MODE: 2 ENQ/ACK COUNTER: 80 ! 

! GAP TIMER: 0 BREAK TIMER; 4 INACT. TIMER: 0 ! 

! MODEM CONNECTION TIMER: 60 CONNECTION: ANSWER ! 

! SINGLE TEXT TERMINATOR CHARACTERS: ! 

! < 12> ! 

! DOUBLE TEXT TERMINATOR SEQUENCE: < 15> < 12> ! 

! PROMPT SEQUENCE: < 21> < 0> ! 

+-+ 
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Emulator Input Diversion 

The emulator can read the contents of a data file and send them to the host computer with 
an emulator input diversion command. Note that this is different from a shell input diversion, 
which is specified when you invoke the emulator. A shell input diversion file may contain local 
commands, just as if you typed them into the emulator interactively from the keyboard. An 
emulator input diversion file is read from the beginning to the end of the file, regardless of the 
file’s contents. This means that commands preceded by the local command character (default 
~) and read from the input diversion file are passed on to the host computer without being 
executed. 

The emulator input diversion command must be: 

~< [:] sfile 

The brackets contain the optional character :. This character causes a silent input diversion. 
If this character is used, the emulator does not display the data read from the file to standard 
output as it is sent to the host computer. Omit this character if you want to monitor the data 
file transfer. 

The sfile is the source file that is to be read for the input diversion. If the emulator is not able 
to open or read this file, a diagnostic is displayed and the diversion is terminated. 

The input diversion can be manually terminated by entering ~<. If there is no diversion occurring 
when the command is entered, there is no effect. You must usually send an appropriate command 
to the host computer before you can start the emulator input diversion. For example, if you 
wish to use the FCOPY utility on an HP 3000 computer, type: 

RUN FCOPY.PUB.SYS 
FR0M=;T0=DESTFILE;NEW 
~<: listf.c 
:E0D 

In this example, these commands invoke the HP 3000 FCOPY. 

RUN FCOPY.PUB.SYS invokes the file copy utility. 

FR0M=;T0=DESTFILE;NEW specifies that data is to be copied to the new permanent file 

DESTFILE. 

~<: listf.c is the local emulator command that causes the contents of 

the file listf.c to be sent to the HP 3000. The use of the 
character : indicates that it is to be a silent diversion (not 
displayed on the CRT). 
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:EOD 


is an FCOPY end of file indicator that completes the FCOPY 
command. 


NOTE 

The "'< command is the only command that may be typed on the key¬ 
board during an emulator input diversion without risking loss of data. 
Note that executing the "'< command in this manner stops emulator 
input diversion. 


Emulator Output Diversion 

You can transfer files from the host computer to the local computer with an emulator output 
diversion command. The command is: 

~>[>][:] dfile 

The character > in brackets can be used to append the data to an existing file. If you omit this 
character, the emulator overwrites an existing file. The : character can be used to specify a 
silent output diversion. If this character is used, the emulator does not write data from the host 
computer to standard output as it is received. If you want to monitor the progress of the output 
diversion, omit this character. 

You can terminate the output diversion at any time by entering the command : 

~> 

To use the emulator output diversion to transfer a data file from the host computer, you usually 
need to enter some command to the host computer that causes the contents of remote file to 
be copied or listed to the data communications line. This command should normally be entered 
after you have started the emulator output diversion. For example, you could use the FCOPY 
utility on the HP 3000: 

RUN FCOPY.PUB.SYS 
~> fileone 
FR0M=M23JUNE;T0= 

~> 
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In this example: 


RUN FCOPY.PUB.SYS 
~> fileone 
FR0M=M23JUNE:T0= 


invokes the FCOPY utility. 

starts the emulator output diversion. 

is an FCOPY command that causes the contents of the file M23 JUNE 
to be copied to the standard output file, which in the case of a login 
terminal is the data communications line. 

terminates the output diversion. 


NOTE 

Since you are diverting the output of the emulator to a file, the command 
to make the host computer list a file is also included in the output file. 
Remove this line from the file with an editor. 


Data Link Break 

Since | Break | on the emulator keyboard is ignored by the terminal emulator, a separate key 
sequence is defined to send a data link break to the host computer. The data link break is the 
local command: 

~# 

You must press RETURN to send a data link break, but only the data link break character is 
sent to the host computer. 
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Terminating the Emulator 

It is recommended that you terminate the emulator with a local command. If you are using the 
default local command character of then the command is: 


If you type CTRL D to signify the end of a file, the emulator sends the control-D character to the 
host computer. However, the terminal emulator performs normal termination procedures when 
an end of file is encountered during a shell input diversion operation. 

If you stop the emulator, or it terminates in an unexpected manner, the local keyboard may 
be left in an undefined state. This is more likely to happen if the emulator is configured for 
host echo disabled and character mode output. If this happens, characters may still be accepted 
by the HP-UX system, even though they are not displayed. To correct this situation, type the 
following command: 

stty sane CTRL—J 

where CTRL—J sends a line-feed character to the remote computer (RETURN cannot be used 
in this case to transmit the line feed). 

Await Prompt Condition 

When you invoke the emulator as a background process using a shell input file diversion, you 
may develop extensive script files to direct the emulator’s automatic operation. When you have 
specified prompt conditions (either handshake or timeout), the emulator waits for the prompt 
condition to be met after the transmission of each data or command line to the host computer. 

The emulator accepts and acts on the first line in the script file without waiting for the prompt 
condition. After each local command (which does not send data to the host computer), the 
emulator accepts and acts upon the next line of the script file without waiting for the prompt 
condition. The command to send a data link break (~#) is not considered to be sending data to 
the host computer. 

To make the emulator wait for a prompt condition without sending any data, use the command: 


This command does not send data to the host, but does cause the emulator to wait for either 
the prompt sequence to be received or the prompt timeout to occur (according to the current 
configuration). While the emulator is waiting for the prompt condition, incoming data from the 
remote computer is accepted and processed. 
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Local Shell Commands 

You can execute a local HP-UX shell command with the emulator running. The command is: 

~! command 

This causes the local HP-UX system to execute a command. For example, if you want to check 
the contents of your local directory, type: 

~! Is -1 

You can also enter a series of local HP-UX local shell commands by typing ~! without any 
commands. You may then type in a series of commands to the local HP-UX shell. While local 
HP-UX commands are executing, the keyboard and CRT are connected directly to standard 
input and output. To terminate a local shell, or to terminate a local HP-UX command that reads 
from the keyboard, enter a line that contains only CTRL D. Normal operation resumes as soon 
as the local command or shell terminates. This is indicated by the prompt ! from the emulator. 

Example: A Script File to Log In to a Remote Computer 

The following script file is used to log the termihal emulator in to a remote VAX computer 
system. 

~*ph - 
~*pt 5 

~*dr 1200 
~# 

bob 
~*ps ? 

~*pt 0 

~*ph + betty 
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When this script file is read by the emulator, the following sequence occurs: 


~*ph - 
~*pt 5 

"♦dr 1200 
“# 

bob 
~*ps ? 
~*pt 0 
"'*ph + 

betty 


Prompt handshake is disabled. 

Prompt timeout is enabled and set to five seconds. 

The emulator is told to wait for a prompt. 

The emulator data rate is set to 1200. 

A break character is sent to the remote computer. The VAX recognizes this as 
a signal to increase the data rate to 1200. 

The emulator is told to wait for the prompt at the end of the VAX login message. 
This prompt must already be specified in the configuration file. 

After the prompt is received, the user name bob is sent to the host computer. 

The prompt character is changed to ?. 

Prompt timeout is set to 0 seconds. 

Prompt handshaking is enabled to respond to the character ?, the last character 
of the line Password? from the VAX. 

After the new prompt ? is received, the password betty is sent to the VAX. The 
emulator should now be logged on to the host computer. 
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Diagnostic Messages (aterm) 

This section lists the diagnostic messages generated by the aterm facility followed by their 
interpretations. Refer to the HP-UX Reference manual for error number (n) information. 


aterm: ASI busy 


aterm: begin input diversion 


aterm: begin output diversion 


aterm: can’t complete modem connection 


aterm: can’t open <file_name> 


aterm: can’t open pipe 


aterm: can’t reconfigure device address 


aterm: can’t reconfigure host name 


aterm: can’t reconfigure modem control 


aterm: can’t reconfigure service type 


aterm: connected 


Another aterm process is currently com¬ 
municating with the device you want. 

The input diversion command was 
successfully processed. 

The output diversion command was suc¬ 
cessfully processed. 

This diagnostic appears only if you have 
a full-duplex modem connection. One 
cause is an open link timeout, which can 
occur on a switched service connection 
if the incoming call (in the case of an au¬ 
todial modem) is not completed within 
one minute. 

The config file or device file could not 
be opened. 

A system error prevented aterm from 
establishing a link between its two pro¬ 
cesses. 

The da parameter may appear only in 
the config file. 

The hn parameter may appear only in 
the config file. 

The me parameter may appear only in 
the config file. 

The ss parameter may appear only in 
the config file. 

The emulator has completed the initial¬ 
ization process and is now ready to ac¬ 
cept data and commands. 
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aterm: data piping terminated 
aterm: device file name too long 

aterm: end of file 

aterm: error n during input diversion 
aterm: error n during output diversion 

aterm: error reading configuration file 

aterm: error n reading remote line 
aterm: error n writing remote line 

aterm: error reading stdin (keyboard) 

aterm: 
aterm: 
aterm: 
aterm: 

aterm: host system name too long 
aterm: input diversion terminated 

aterm: invalid data rate 

aterm: invalid host echo 
aterm: invalid input mode 
aterm: invalid local character set 

aterm: invalid modem control 
aterm: invalid number of data bits 


The pipe to the aterm co-process was 
unexpectedly closed. 

The name you used for your device file 
contained more than 31 characters. 

The end of file was encountered during 
an input diversion. The diversion is ter¬ 
minated. 

Error n indicates the error that oc¬ 
curred. 

Either the config file does not exist or it 
is not accessible. 

Line error n occurred. 

There is a serious problem with stdin. 

The device you specified is probably in¬ 
correct. You specified a driver other 
than 19 with mknod. 

The name used for the host system con¬ 
tained more than 31 characters. 

You manually terminated an input diver¬ 
sion. 

The only acceptable values are: 

50, 75, 110, 134.5, 150, 300, 600, 
900, 1200, 1800, 2400, 3600, 4800, 
7200, 9200 and 19200. 

Only the ‘-f’ or is valid. 

Only ‘1’, ‘c’ or ‘b’ is valid. 

The only permitted values are: usa, f, 
d, gb, e, s, i, dk and ec. 

Only ‘-H’ or ’ is valid. 

The only acceptable values are: 5, 6, 7 
and 8. 


gen i/o read reg n failed, errnoe 
gen i/o write reg n failed, errnoe 
gen i/o read str reg n failed, errnoe 
gen i/o write str reg n failed, errnoe 
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aterm: invalid number of stop bits 

aterm: invalid output character gap 

aterm: invalid output mode 

aterm: invalid parity 

aterm: invalid prompt handshake 

aterm: invalid prompt timeout 

aterm: invalid remote character set 

aterm: invalid service type 

aterm: invalid signal rate selector 

aterm: invalid terminal/host ENQ/ACK 

aterm: keyboard data ignored during 
input diversion 


aterm: keyboard data ignored while 
awaiting prompt condition 

aterm: MUX busy 


The only acceptable values are 1, 1.5 
and 2. 

The only acceptable values are in the 
range 0 through 254. 

Only ‘c’ and i’ are valid parameters. 

The only acceptable values are: n, 0, 1, 
o and e. 

Only the ‘+’ or ’ is valid. 

The prompt timeout must be a number 
in the range 0 through 600. 

The only permitted values are: usa, f, 
d , gb , e, s, i , dk, and e c. 

Only ‘a’ or ‘o’ is valid. 

Only the ‘+’ or is valid. 

Only ‘+’ or ’ may be specified. 

The emulator accepts only local com¬ 
mands during an input diversion. These 
local commands include display status, 
terminate diversion and change commu¬ 
nication parameters. If you attempt to 
send normal data from the keyboard to 
the host computer during an input di¬ 
version, the emulator ignores the data 
and displays this message. 

This is a warning of an error in transfer¬ 
ring data, i.e., unrecognized handshake, 
involving the loss of data. 

Another aterm process is using the 
MUX. 


(XON/XOFF) 
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aterm: open of <file_name> failed, error 


aterm: output diversion terminated 


aterm: read pipe error 


aterm: terminated 


aterm: unknown command name 


aterm: use * to send line starting 

with ’~ * 


aterm: waiting for modem connection 


n Aterm could not open the specified file. 
For example, if you should get an Error 
6 this usually indicates that the serial 
driver is not installed as described in the 
section, “Asynchronous Terminal Emu¬ 
lator” of the chapter, “Software Config¬ 
uration” in this manual. 

You manually terminated output diver¬ 
sion. 

An error occurred communicating with 
the co-process. 

The emulator recognized a termination 
condition. 

Aterm does not recognize the command 
you entered. 

The emulator uses this diagnostic in re¬ 
sponse to an unrecognized local com¬ 
mand. If you intend to send a line start¬ 
ing with the local escape character to 
the host computer, you should re-enter 
the line, remembering to repeat the first 
character. 

The emulator issues this message to in¬ 
dicate that an open link is being at¬ 
tempted on a connection you have con¬ 
figured as a full-duplex modem. If you 
specified the switched service type as 
manual call or originate, you have one 
minute to complete the connection. If 
you specified auto-answer, then the one 
minute interval does not begin until an 
incoming telephone call is received. 
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usage: aterm cfile 


You omitted the configuration file when 
you invoked the emulator or have in¬ 
cluded additional unrecognized options. 


Problems 

This section discusses those problems you are most likely to encounter while using aterm. 


Bad Connections 

Bad connections are by far the most common problem encountered when using aterm. Direct 
and modem connections both present occasional difficulties when contacting remote systems. 

If you are using a modem link, check the modems and make sure they are compatible. Using 
the cu command, interactively try to call the other system over the problem line. 


Using Aterm 
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This chapter discusses how to set up data communication links between computers, and explains 
software configuration procedures that must be completed before aterm can be used. 

Installing data communication links involves the following steps: 

1. Determine the type of connection that is needed, and what interfaces are appropriate; 
that is: should a direct or modem connection be used; does the connection require an 
asynchronous serial interface (ASI) card, or can a multiplexer (MUX) be installed instead 
for more efficient use of I/O slots. 

2. Install interface(s). 

3. Install modem(s) if a modem connection is being used. 

4. Install interface cables as appropriate for the type of connection being used. 

5. Build and install any necesary adapters (this usually applies only in the case of direct 
connections). 

Data Communication Links 

The data communication (datacomm) link is a direct or modem data path between the terminal 
or computer and another computer that is acting as host. Direct connections consist of cables 
and adapter wiring directly between the two computers, and are commonly used over short 
distances where noise is not a problem (about 17 metres, 50 feet, is considered the maximum 
recommended length of a direct connection, although direct connections have been successfully 
used over much longer distances when there is little electrical or magnetic noise present. 

Modem connections are used for longer distances, and telephone lines usually provide the data 
path. A modem (MOdulator-DEModulator) is used to convert the digital data from the computer 
into a form that can be handled by standard telephone circuits. This method of transmission is 
much less sensitive to external noise effects than direct connections. 

The type of datacomm link being used affects the available choice of interfaces for the connection. 
Aterm supports only the HP 27128A ASI card and the HP 27130A/B 8-channel MUX card on 
the terminal computer. Only the ASI card can be used with modem connections. The 8-channel 
MUX card is usually preferred for direct connections because it can support eight datacomm 
links on a single I/O select code, whereas the ASI card supports only a single link. Aterm does 
not support 6-channel MUX cards. 


Emulator Configuration 21 




Be Careful 

when planning datacomm connections between systems, and especially between HP-UX (or sim¬ 
ilar) systems that support uucp and cu facilities. Wiring configurations that work well for aterm 
may not be suitable for other facilities, and configurations that are necessary for other facilities 
(such as links that must support active gettys at both ends simultaneously) may be incompatible 
with aterm's capabilities and limitations. If you are concerned about potential compatibility con¬ 
flicts, compare the datacomm link discussions in this tutorial and the tutorial(s) related to other 
HP-UX datacomm facilities being used. 

Interface Card Installation 

Only two interface models can be used with aterm. If a modem connection is being used, an 
ASI card must be installed in the aterm computer. If you are using a direct connection, either 
interface will work, but the 8-channel MUX is preferred because it can be connected to several 
terminals while consuming only one I/O slot in the computer. 


CAUTION 

Interface cards contain components that are sensitive to damage from 
electrostatic discharge. Be sure to follow special handling procedures for 
static sensitive devices when configuring and installing the card. Keep 
the card in its special conductive plastic bag while unpacking the card 
from its shipping container and setting the configuration switches. 


Card Configuration 

The ASI card has a cluster of card configuration switches. Set switches S2 and S8 in their 
DOWN position, and the remaining switches UP. No other configuration of the ASI card is 
needed. Software overrides in aterm configure the card as needed for correct operation. 

There are no configuration switches on the 8-channel MUX card. 
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Card Installation 

• Be sure the power to your computer is OFF. 

• Hold the interface card by the two extractors on the outside corners of the card and slide 
it into the I/O slot on the computer. Push the card into the internal backplane connector 
until it is fully seated. 

• Install and connect the DTE (male) ASI card modem cable (HP 27128A Opt. 001) or 
MUX cable and connector assembly to the interface. The conductive grommets on the 
interface cable must be seated correctly in the computer frame for proper radio-frequency 
interference shielding. Refer to computer installation manuals for correct procedures. 
Connecting the cable or MUX connector box to other cables and equipment are discussed 
in the next topic. 
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Connecting Interface Cables 


Modem Connections 

If the distance between your computer and the remote system is more than about 15 meters 
(50 feet) or if noise on a direct connection line becomes a problem, a modem connection is 
recommended. 

Modem connections for Series 500 computers require an HP 27128A Asynchronous Serial 
Interface (ASI) card whose firmware revision number is 27128-80005 or greater. Only the DTE 
(male) modem cable (HP 27128A Opt. 001) can be used to connect the ASI card to the modem. 
Other cables are not suitable for connecting the ASI card to modems. 



A Typical Modem Connection 

Modem connections on Series 500 computers can handle both incoming and outgoing calls over 
single line. No special modification is necessary; simply connect the DTE (male) cable from the 
interface to the modem. 
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During software configuration, the mknod command is used to associate a special (device) file 
with the interface card on a specified select code, and a flagging mechanism assigns the line 
as either an incoming or outgoing port. Procedures are explained under the topic heading, 
“Creating a Device File”, in the Software Configuration section of this chapter. 

Direct Connections 

Direct connections can be made between two ASI cards, or between an ASI card and any 
other compatible interface on a Series 500, Series 200 or other host computer. This section 
provides examples for each of these combinations, so you should have no difficulty matching 
one to your needs. Note that two DTE (male) cable ends cannot be connected together unless 
an appropriate adapter is inserted between them. Exploded views show adapter wiring when 
an adapter is needed. Construction notes for a typical adapter follow the examples. Note that 
aterm cannot be run on any computer containing a 6-channel MUX card. The aterm computer 
must contain an 8-channel MUX or ASI card. 



Emulator Configuration 25 




26 Emulator Configuration 





Scries 500 MUX to Scries 500 6-channel MUX 
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Scries 500 ASI to Scries 500 6-channel MUX 
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INTERFACE CARDS: 
HP 27128A 




E 
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INTERFACE CARD: 

HP 98626A OR HP 98628A 


HP 98626/28A 
OPT. 001 




SERIES 200 


DTE CONNECTOR 
HP 27130A/B 



SERIES 500 


Series 500 MUX to Series 200/300 


You should be aware of these additional considerations when making direct connections: 

• Series 200/300 computers can use an HP 98642A (4-channel multiplexer) in place of 
an HP 98626 or HP 98628 interface card; however, you must treat the modem port as 
an HP 98626A or HP 98628A connection and you must treat HP27130A/B (8-channel 
multiplexer) ports as multiplexers with 3-wire cables. 

• Series 200/300 computers making direct connections using an HP 98644A card should 
treat this card as if it were an HP 98626A card. 

• Aterm will not work with an HP27140A (6-channel multiplexer), on any port that has a 
gettx; on it, or with any direct connection active in both directions. 

Making a Special Connector 

The “special connector” is not a part numbered item that can be purchased. This connector has 
to be made using special parts. A list of the necessary parts is given as follows: 

• Two DCE (25-pin RS-232C female connectors HP part number: 1251-0063 or equivalent) 
connectors, 

• Two lV 2 -inch long (4 cm) machine screws (HP part number: 2200-0125 or equivalent) 
with nuts and lock washers (Note, these machine screws should be of the proper size to 
fit through the holes on both sides of the connectors and should not be so long that they 
keep you from plugging in the conncector.). 
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• Four 0.625-inch metal (HP part number: 0380-0010) spacers or two 1.25-inch spacers to 
match the screw length and allow sufficient extra for the nuts and washers, 

• Eight 1-inch (2.5 cm) long pieces of 24 gauge insulated hook-up wire stripped about V 4 
inch (6 mm) at each end for soldering. 

The “special connector” should look like the following example when assembled: 


1" WIRE 



DCE CONNECTOR 
(RS-232C) 


1-1/4" SPACER 


Wiring diagrams on preceding pages in this chapter provide a useful wiring guide for the adapter 
connector. The exact cross-wiring required may vary, depending on the type of remote system 
being accessed. 
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Software Configuration 

This section discusses the required software configuration for supporting aterm on Series 500 
computers. Aterm runs only on Series 500 computers. To use aterm the System Administrator 
must: 


• Load the SERIAL.opt driver in the boot area of the system disc unless tests show that the 
SERIAL.opt driver is already there. 

• Create a device file. 

• Prepare a configuration file. 

• Install the aterm program. 

Loading the SERIAL.opt Driver 

The SERIAL.opt driver is not normally included when HP-UX is first installed. Use the following 
procedure to install it: 

1. Before installing the SERIAL.opt driver, test to see that it has not been previously installed 
by typing: 

osck -V /dev/hd RETURN 

If the SERIAL.opt driver has been installed, skip the remaining steps 2, 3, and 4, and 
continue with device file creation. 

2. Determine which HP-UX system software model number you are using from this list (for 
example, 97078C): 

— 97070C Model 520 single-user system 

— 97078C Model 520 multi-user system for 32 users 

— 97079C Model 530/540/550 single-user system 

— 97080C Model 520 multi-user system for 16 users 

— 97088C Model 530/540/550 multi-user system for 32 users 

— 97089C Model 530/540/550 multi-user system for 16 users 
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2. Type: 


oscp -a /systein/970xxA/SERIAL.opt /dev/hd RETURN 

The -a option appends to an existing operating system from a list of ordinary files, 
and puts the result in the operating system boot area of the system disc. File / sys¬ 
tem/97 Oxxk/SERIAL, opt contains the driver being copied to the boot area, xx in the 
driver file pathname shown represents two digits needed to complete the correct model 
number taken from the list in Step 1. For example, if the system model number is 97070A, 
XX corresponds to the digits 70. /dev/hd represents the name of the special (device) file 
associated with the system disc. 

3. Verify that the file has been copied into the boot area by typing: 

osck -V /dev/hd RETURN 

4. To activate the SERIAL.opt driver, reboot the system by typing: 

/etc/reboot -r RETURN 


Error 6 results if you attempt to use aterm without the SERIAL.opt driver (19) being installed 
and active. 


Creating an ASI or MUX Device File 

To configure the emulator, you need to know the name of the special (device) file associated with 
the ASI (HP27128A) or 8-channel MUX (HP27130A/B) card on your system. The name is 
defined when the system administrator creates the device file by executing the mknod command: 

mknod pathname mode driver OxScAdUV 


where: 


pathname is the name of the device file you are creating including the directory path to the 
file. 


mode 

driver 


Ox 

Sc 

Ad 


is c to specify a character-mode device. 

is 19, the number that identifies the general-purpose SERIAL-GSG driver used 
with the ASI and 8-channel MUX in aterm applications. 

indicates that all following digits are to be interpreted as hexadecimal. 

is the select code of the ASI or MUX card in hexadecimal notation (use two digits 
with a leading zero if needed). 

is two hexadecimal digits representing the port number on the MUX with a leading 
zero. Valid values are 00 through 07. Use 00 for ASI cards. 
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U is a single-digit hexadecimal value specifying a secondary address, such as a 

device unit number. This value must be 0 for aterm. 

V is a single-digit hexadecimal value specifying a secondary address, such as the 

volume number in a multi-volume disc drive. This value must be 0 for aterm. 


For example: 

mknod /dev/asi4 c 19 0x040000 RETURN 

creates a device file named /dev/asi4 that is associated with select code 4, bus address 0. 

Preparing the Configuration Fiie 

Before running aterm, you must prepare a configuration file. Aterm reads this file in order 
to establish the correct operating conditions for communicating with the host computer. The 
configuration file is a normal HP-UX text file, so you can use any text editor to create and update 
it. 

Each configuration command occupies one text line in the file, and consists of a two-character 
command name followed by one or more blanks and the command argument value. No leading 
blanks or other characters can precede the command name. 

The following table lists all recognized configuration command names with other accompanying 
information: 

• The name of the parameter whose definition or value is altered by the command. 

• Description of the parameter, and acceptable arguments or values that can be used with 
or are required by the given command. 

• The default value (if any) that is used if the command is not included in the configuration 
file. 

The only required configuration command that does not have a default value is the special 
(device) file name that is associated with the ASI or MUX card. 

The range of acceptable values for given parameters in the table and some of the behavioral 
characteristics of aterm depend on the type of interface being used. For example, modem control 
and switched service commands are meaningless if you are using a MUX card, and the emulator 
Break key works only with an ASI card. Refer to the Diagnostic Messages section at the end of 
Chapter 1 for additional information. 
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The arguments associated with each of the last six commands in the table (beginning with st) 
consist of one or more literal characters. These characters are often ASCII control characters 
whose binary values fall in the range of 0 through 37 octal. To express an ASCII control character 
as an argument to such commands, use the circumflex notation convention. For example, is 
equivalent to a carriage return whose octal code value is 015 octal. See the appendix heading, 
“HP 9000 Character Codes” for a list of circomflex-notation codes. To use a circumflex character 
as an argument to a command instead of part of a control character representation sequence, 
precede it with a backslash ( \ ). 



Parameter 

Description and Acceptable Values 

Default 

da 

Device address 

Device file name of the ASI (unquoted sequence 
of non-blanks). 

No default 

hn 

Host name 

Name of host computer system, for documenta¬ 
tion only (unquoted sequence of non-blanks). 

No default 

db 

Data bits 

Number of data bits per character: 5,6,7,or 8. 
Note that the parity bit is in addition to data bits 
when parity is even or odd, but is included in the 
data bit count when parity is set to zero or one. 

7 

sb 

Stop bits 

Number of stop bits per character: 1, 1.5, or 2. 

1 

pa 

Parity 

Character parity: none (n), odd (o), even (e), zero 
(0), or one (1). The parity bit on incoming data is 
stripped and ignored if parity is zero or one. 

o 

dr 

Data rate 

Rate for data sent and received; valid rates are 
50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 
2400, 3600, 4800, 7200, 9600, or 19200 baud. 

2400 

me 

Modem Control 

Enables (+) or disables modem handshake. If en¬ 
abled, switched service command can be used to 
select auto-answer or manual originate by moni¬ 
toring the carrier detect signal from the modem. 

If disabled, carrier detect is ignored. 


ss 

Switched service 

Auto-answer (a) or manual originate (o); relevant 
for modem lines only. 

o 

Sa 

Gap 

Specifies the time delay between successive char¬ 
acters in a data transmission as a multiple of the 
average time required to send a single character. 
Acceptable values are 0 through 254. 

0 

ec 

Echo 

Enabled (+) if the host computer echoes charac¬ 
ters sent by the emulator, disabled (-) otherwise. 

+ 
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Name 

Parameter 

Description and Acceptable Values 

Default 

te 

Terminal ENQ/ACK 

Handshake for data sent by the host computer; if 
enabled the emulator responds with ACK when 
ENQ is received and the data buffer is available; 
enabled (+) or disabled (-). 

+ 

he 

Host ENQ/ACK 

Handshake for data sent by the emulator; if en¬ 
abled the emulator sends ENQ and waits for 
ACK from the host computer: enabled (+) or 
disabled (-). 


tx 

Terminal XON/XOFF 

Handshake for data sent by the host system. If 
enabled, the emulator sends XOFF to suspend 
transmission an XON to resume: enabled (+) or 
disabled (-). 


hx 

Host XON/XOFF 

Handshake for data sent by the emulator; if en¬ 
abled the emulator suspends transmission when 
XOFF is received and resumes when XON is 

received. 


im 

Input mode 

Method for accepting and processing input data 
from the host computer; buffered (b), character 
(c), or line (1). 

b 

om 

Output mode 

Method for sending data to the host computer; 
character (c) or line (1). 

c 

ph 

Prompt handshake 

If enabled (-h), the emulator waits for the prompt 
sequence before sending each line of data during 
an input diversion; if disabled (-), no wait is 
performed. 


Pt 

Prompt timeout 

Number of seconds to allow for receipt of a 
prompt sequence during an input diversion. If 
prompt handshake is disabled, then the emula¬ 
tor always waits this length of time (1 to 600, 0 
disables timeout). 

0 

st 

Single text 
terminators 

List of characters, any of which terminates a line 
sent by the host computer when the emulator is 
input line mode; up to eight characters may be 
specified. 

None 

dt 

Double text 

terminator 

A pair of characters which together terminate a 
line sent by the host computer when the emula¬ 
tor is in input line mode. 

CR LF 
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Name 

Parameter 

Description and Acceptable Values 

Default 

ps 

Prompt sequence 

One or two characters which terminate a line 
sent by the host computer when the emulator is 
in input line mode, and which satisfy the prompt 
handshake if enabled. 

DCl 

bl 

Beginning 
of line 

Character to prefixed to each line sent to the 
host computer. 

None 

el 

End of line 

One of two characters to be postfixed to each 
line sent to the host computer. 

CR 

es 

Local command 
character 

Character which designates a local command to 
be interpreted by the emulator if it comes at the 
beginning of a line read from standard input. 



Emulator Modes and Handshaking 

Input Modes 

The input mode specifies the method used by the emulator for accepting and processing input 
data from the host computer. The mode you select, character, buffered, or line, affects emulator 
appearance and efficiency. 

• Line input mode causes the emulator to accept data from the host system one line at a 
time. In this mode, you must specify single and double text terminator characters and one 
or two prompt sequence characters sent by the host computer to mark the end of a line. 
All incoming data is stored in a private buffer on the HP 27128A (ASI) card until one of 
these characters is received. 

Line input mode is the most efficient mode for the terminal emulator, and should be used 
whenever possible if efficiency is a concern. Not every host computer system guarantees 
the transmission of required terminator characters, which may prove to be a problem if 
visual prompts are to be used. For example, the host computer may transmit: 

IF IT IS OKAY TO CLEAR. RESPOND "YES" OR "Y" 

CLEAR? 
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The cursor may be left immediately after the question mark (this is known as a visible 
prompt). If the host computer has no defined prompt sequence, it does not notify the 
emulator that a partial line has been transmitted and needs to be displayed. Since there 
is no end-of-line character, the emulator does not display the second line. 

The HP 3000 is one computer that utilizes a prompt sequence to solicit input from 
interactive terminals. The character used for a prompt is DCl. 

• Character input mode processes data as it is received, one character at a time. Character 
input mode requires a great deal of interaction time between the HP 27128A (ASI) card 
and the main processor, and is also limited by delays caused by some CRT models. These 
limitations may not be apparent when using a 300 bit-per-second modem connection, but 
they can restrict throughtput and cause the emulator to fall behind and lose data if one of 
the terminal handshakes is not enabled. 

• Buffered input mode behaves much like character input mode, except that if the emulator 
begins to fall behind the transmitted data, the ASI buffer begins to fill. When the emulator 
reads the contents of the ASI buffer, the entire contents of the buffer are read, rather 
than just one character. This requires only one interaction between the ASI and the main 
processor. If there is no data in the buffer, the main processor waits for the buffer to fill. 


NOTE 

The enable prompt timeout command is only effective for buffered input 
mode. It does not work for line or character input modes. 

Be sure to define a prompt sequence and enable a prompt handshake 
to prevent data loss. 


Output Modes 

There are two output modes available to communication with the host computer. 

• Character output mode passes the data from the terminal keyboard to the host computer 
one character at a time. All data characters, including the back space character, are 
sent to the host computer without any processing by the terminal emulator. If you have 
configured echoing as enabled (the host computer echos data sent to it), then local echoing 
is suppressed. In this mode, when you type a character, it will not appear on the CRT 
until it has gone to the host and back again. 
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• Line output mode transfers entire lines of data from the keyboard to the host. You must 
press RETURN to finish the line and send it to the host computer. In this mode, you can 
edit a line before sending it to the host computer. 

The emulator is more efficient when configured for the line output mode, but for normal typing 
the difference is not significant. If the host computer has awkward editing conventions (such as 
not recognizing Back space), you may prefer to use line output mode. If you require character- 
by-character interaction with the host computer, you should use the character output mode. 

Prompt Handshaking 

Several parameters in the configuration file control the flow of data from the terminal to the 
host system. The values chosen for these parameters will affect how the emulator performs as 
a background process, using a shell input re-direction to provide a script file to the host system. 

Some host systems provide a fixed prompt sequence. The HP 3000 provides a DCl character 
to ask for the next data or command line from the connected terminal. For such a host, you 
must specify the correct prompt character and enable the prompt hankshake. 

Other host systems provide a high-performance path for accepting data and commands from a 
terminal. For example, the host system may provide a large amount of buffering (“type-ahead”) 
combined with fast input processing compared to the data rate of the link. In such cases, 
especially if a host flow control (DC1/DC3 or ENQ/ACK handshake) is available, you may find 
that you can disable the prompt handshake without losing data. 

For some host systems, you may need to experimentally develop the correct sequence of prompt 
control configuration commands to run the emulator as a background process. The commands 
you need to include in your script file are described in the section, “Local Commands” found in 
the chapter, “Asynchronous Terminal Emulator”. 
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Example Configuration Fiies (aterm) 

To prepare a configuration file, you must first prepare a list of the host computer’s communication 
parameters. For this example, the host computer is a VAX 11/750 and connection is to be 
made through a modem. The communication requirements for this example computer are: 

8 data bits zero parity 300 bits/second data rate Connection through a modem, manual originate 
No terminal or host ENQ/ACK Terminal XON/XOFF handshake 

All of the other communications parameters are the default values, and do not need to be 
changed. The ASI device file name of the HP27128A (ASI) card is /dev/asi3. 

The configuration file for these requirements is: 

da /dev/asi3 

hn VAX_modem_connection 

dr 300 

db 8 

pa 0 

me + 

te - 

tx + 

An example configuration file for the HP 1000 is: 
dr 1200 

hn NAME_phone_number 
pa 0 
db 8 

da /dev/asi04 

he - 

te + 

me - 

om c 

im b 

el 

ec + 

An example configuration file for the HP 3000 is: 

da /dev/muxb2 
ec + 

hn hp3000_name 
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An example configuration file for a UNIX system is: 

da /dev/asi04 
dr 1200 
pa e 
db 7 
ec + 

An example configuration file for a multiplexer is: 

da /dev/muxbl 
dr 9600 
pa e 
db 7 
ec + 
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Series 200/300/500 
Character Codes 



The following tables list the characters available for the internal printer and display of the Model 
520 computer. The representation for a Series 200/300/500 external printer or terminal 
may differ. For each character, the tables show its graphic representation on the printer, its 
description and its binary, octal, decimal and hexadecimal code value. 

If the character is a control character, it may not print or display unless the DISPLAY FUNC¬ 
TIONS mode of the device is enabled. ASCII control characters can be generated by simultane¬ 
ously pressing CTRL and the key listed in the CTRL Char column of the table. 

Table A-1. ASCII Character Codes 


Gra¬ 
ph i c 

CTRL 

Char- 

ASCII Character 

A b b r- e u i at i q n, D e s c r i p t i o n 

Einary 

Oct 

CHR$ 

Dec 

H e X 

y. 

0 

NUL,Nul1 

00000000 

0 0 0 

000 

00 


fi 

S 0 H , S t a r t 0 f H e- a d e r 

00000001 

001 

001 

01 


E 

S T X , S t ar t 0 f T e x t 

00000010 

002 

002 

02 

%. 

c 

E T X , E ri t J 0 f T e x t 

00000011 

003 

003 

03 

Er 

n 

E 0 T , E n d 0 f T r an s m i s s i o n 

00000100 

0 0 4 

004 

04 

Ell 

E 

E H Q , E n q u i r y 

00000101 

0 0 5 

005 

05 

1=!. 

F 

A C K , A c k n o w 1 e d g e 

00000110 

0 0 6 

0 0 6 

06 

E; 

G 

E E L , Ee 1 1 , at t e-n t i on s i gn a 1 

00000111 

007 

0 0 7 

07 

Ej 

H 

E S , E ac k s p ac e- 

00001000 

010 

008 

08 

*v 

I 

HT,Horizontal Tab 

00001001 

011 

0 0 9 

09 

If 

J 

L F , Li n a - f e e d 

00001010 

012 

010 

0A 


K 

VT,Vertical Tab 

00001011 

0 1 3 

011 

0E 


L 

F F F o r ri - f e e d 

0 0 0 0 1 1 0 0 

014 

0 1 2 

0C 

•P: 

M 

C R , C ar r i ag e - r e t u r- n 

00001101 

015 

0 1 3 

011 


N 

S0,Shift Out 

00001110 

016 

014 

0E 

-I 

0 

S I , S h i f t I n 

00001 1 1 1 

017 

0 1 5 

0F 

'L 

P 

D L E , D at a L i n k E s c ap e 

00010000 

020 

016 

1 0 


Q 

Ii il: 1, n ei c e C o n t r o 1 1, X - 0 N 

00010001 

021 

017 

1 1 


R 

D C 2 , D e '..1 i c e C o n t r o 1 2 

00010010 

022 

0 1 8 

12 


5 

n C 3,D e Mic e C o n t r o1 3,X-OFF 

0 0 0 1 0 0 1 1 

023 

019 

13 


T 

n C 4 , D 6' i c e C o n t r o 1 4 

00010100 

024 

020 

14 

rj. 

iJ 

N A K , N e q a t i m e A c k n o w 1 e d g e 

00010101 

025 

021 

15 

j. 

V 

S Y N , S y M c h r o n o u s i d 1 e 

0 0 0101 1 0 

026 

022 

16 

% 

W 

E T E , E n d T r an s m i s s i o n E1 o c k 

00010111 

027 

023 

17 

'm 


CAN,Cane e1 

00011000 

030 

024 

18 


Y 

E0M,End Of Medium 

00011001 

031 

025 

19 

% 

z 

S IJ E , S u b •=. t i t u t e 

00011010 

0 3 2 

026 

lA 

5; 

C 

ESC,Escape 

00011011 

033 

027 

IE 

Fj 


F :5 , F i 1 a S e p ar at o r 

00011100 

034 

028 

1C 

ij 

] 

G S , G r o 1 J p S e p a r a t o r 

00011101 

0 3 5 

029 

ID 

R- 


R S , R e c □ r d S e p ar a t o r 

00011110 

036 

030 1 

IE 


i_Z_1 

U S, U n i t S e p ar at o r 

1_1 

00011111 

1_1 

037 

1_1 

031 

1_1 

IF 
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Table A-1. ASCII Character Codes (continued) 


La P -il ~ 

p h i c 

fl S C11 C h a r a. c t e r 

Desc ri pt ion 

E i n -ar y 



B 


Space, Blank 

00 1 00000 

040 



! 

E X c 1 am at. i o n p o i n t 

00100091 

041 

033 

21 

" 

Quot -at i on m-ark 

0 0 1 0 0 0 1 0 

042 

034 

22 

# 

P o u n d s i g n, N u m b e r s i g n 

00100011 

043 

035 

23 

■$ 

D o 1 1 an s i g n 

00100100 

044 

036 

24 


Percent sign 

00100101 

045 

037 

25 

& 

flmpersand 

00100110 

046 

038 

26 


R p o s t r o p h e, R c u t e a c c e n t 

001001 1 1 

04? 

039 

27 

< 

0 p e n i n g p a r e n t h e s i s 

00101000 

0 5 0 

040 

28 


C 1 o s i n g p .ar a n t h e s i s 

00101001 

051 

041 

29 

* 

Rsterisk, Star 

00101010 

052 

042 

2R 

+ 

Plus 

00101011 

053 

043 

2E 

, 

C o rn rn a, C e d i 1 la 

00101100 

054 

044 

2C 

- 

H y p h e n, M i n u s, D -a s h 

00101101 

055 

045 

211 


P e r i o d, D e c i m a 1 P o i n t 

00101110 

056 

046 

2E 


S1 ant, S1 as h, S o 1 i d u s 

001011 1 1 

057 

047 

2F 

0 

Z e r o 

0 01 10 0 0 0 

060 

048 

30 

1 

One 

00110001 

061 

049 

31 

2 

Two 

00110010 

062 

050 

32 

3 

T h r e e 

00110011 

063 

051 

33 

4 

F o u r 

00110100 

064 

052 

34 

5 

F i M e 

00110101 

065 

053 

35 

6 

S 1 X 

00110110 

0 6 6 

054 

36 

7 

Seoen 

00110111 

067 

0 5 5 

37 

8 

E i ght 

00111000 

070 

056 

38 

9 

N i ne 

00111001 

071 

057 

39 

: 

Co 1 on 

001 11010 

072 

058 

3R 

5 

Semi col on 

00111011 

073 

059 

3E 

< 

Less than 

00111100 

074 

060 

3C 

= 

Equals 

00111101 

075 

061 

311 

> 

Greater than 

00111110 

0 7 6 

062 

3E 

■? 

Question mark 

00111111 

077 

063 

3F 

0 

Commerc i al -at 

01000000 

100 

064 

40 

R 

Uppercase R 

0 1 0 0 0 0 0 1 

101 

065 

41 

E 

Uppercase E 

01000010 

102 

066 

42 

C 

Uppercase C 

01000011 

103 

067 

43 

n 

Uppercase D 

01000100 

104 

068 

44 

E 

Uppercase E 

01000101 

105 

069 

45 

F 

Upperc-ase F 

01000110 

106 

070 

46 

G 

Uppercase G 

01000111 

107 

071 

47 

H 

Uppercase H 

01001000 

110 

072 

48 

I 

Uppercase I 

01001001 

1 1 1 

073 

49 

J 

Uppercase J 

01001010 

112 

074 

4R 

K 

Uppercase K 

01001011 

113 

075 

4E 

L 

Uppercase L 

01001100 

114 

076 

4C 

M 

Upperc-ase M 

01001101 

115 

077 

4D 

N 

Uppercase N 

01001110 

116 

078 

4E 

0 

Uppercase 0 

1 

01001111 

1-1 

117 

1_i 

079 

_1 

4F 
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ASCII Character codes.43-45 

Auto-answer modem . 3 

Await prompt .12 

b 

BREAK .11 

Break, Data Link .11 

Buffered input mode .39 

C 

Cables, datacomm.24-32 

Cables, interface.24-32 

Changing configuration. 5, 6, 7 

Character input mode .39 

Commands, configuration . 5, 6, 7 

Commands, configuration file .36-38 

Commands, local . 5 

Configuration, changing . 5, 6, 7 

Configuration commands. 5, 6, 7 

Configuration display . 7 

Configuration file .1, 3 

Configuration file commands .36-38 

Configuration file example. 41, 42 

Configuration file, preparing.35 

Configuration, interface card .22 

Configuration, software.33 

Connection timeout . 3 

Connection to remote computer . 3 

Connections, bad .19 

Correcting typing errors . 5 
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d 

Data Link Break.11 

Datacomm cables .24-32 

Datacomm link installation.21-32 

Device Files.34 

Diagnostic messages .15-19 

Display, configuration. 7 

Display, status . 8 

Diversions. 4,9,10 

e 

Emulator commands . 5 

Emulator Modes .38 

End of File .12 

Error diversions . 4 

Error messages.15-19 

Errors, typing . 5 

Escape to shell.13 

Example: 

Login script .13 

f 

File, end of .12 

File transfers . 4 

Files, Device Special .34 

h 

Handshaking .38 

Handshaking, prompt. 40 

■ 

I 

Input diversions . 4, 9, 12 

Input modes . 38, 39 

Installing datacomm links .21-32 

Installing interface cards .22-23 
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Interface cables .24-32 

Interface card installation .22-23 

Invocation of aterm . 3 

I 

Line input mode.38 

Line output mode.40 

Local commands. 5 

Local shell commands .13 

Local shell termination .13 

m 

Messages, diagnostic .15-19 

mknod.34 

O 

Output diversions .4, 10 

Output modes . 39, 40 

p 

Preparing configuration file .35 

Problems .19 

Prompt .12 

Prompt Handshaking .40 

S 

Serial Interface status. 8 

SERIAL.opt Driver .33 

Shell escape command .13 

Special connector .31-32 

Special Files .34 

Status display . 8 

Status, Serial Interface . 8 
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t 

Terminating diversions . 9, 10 

Terminating local shell .13 

Terminating the Emulator .12 

Tilde character. 5 

Timeout, connection . 3 

Troubleshooting . 19 

Typing errors. 5 

w 

Wait for prompt . 2 
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Assembler Reference Manual 

Program Instructions 

Program Statement Format 

Assembly programs are written with one instruction allowed per line. Mnemonic operation codes 
(opcodes) and register symbols must be written in lowercase. Uppercase and lowercase characters 
cannot be used interchangeably (the assembler is case sensitive). The number of spaces used to 
separate elements within an instruction line are not significant (one blank or multiple successive 
blanks are treated identically). 

If a label is present, it must start in the first column of the instruction line. The opcode must 
start in column two or later (at least one blank must separate label, if present, and opcode). 
Blanks are not permitted within the operand field. The first blank encountered after the start 
of the operand field begins the comment field. Here is an example of how typical instruction 
lines are structured. The first line of numbers identify column positions, and are not part of a 
program. 

12345678901234567890123456789012345678901234567890 
Label move al,a2 comment field 

An asterisk (*) in column one indicates that the entire line is a comment: 
12345678901234567890123456789012345678901234567890 
* 

* These are comments. 

* 
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Symbols 

Symbols must begin with an alphabetic character, but can contain letters, numbers, @, $ and 
Symbols can contain any number of characters, but each program statement must be entirely 
contained on one line. 

When the asterisk (*) is not located in the first column of the statement line (comment field), it 
is interpreted as a symbol having the value of the program counter. Normally, it appears only 
in the operand field of the program statement unless the statement is a comment. 

Register symbols refer to the pre-defined registers aO through a7, dO through d7, sp, pc, ccr, 
and sr. 

Local Labels 

A local label has the form <c/igit>$. A local label can be used to label any machine instruction. 
Any number of occurrences of the same local label is allowed within an assembly source file. 
When a local label is referenced, the reference refers to the nearest declaration of the local label. 

Opcodes 

Most opcodes and their syntaxes are defined in the microprocessor manual shipped with your 
system. Size suffixes are allowed only for those operations which include a size field in the 
instruction and for the conditional branch bcc. In addition to the opcodes listed in the manual, 
the Series 200/300 assembler recognizes some variants. For the bcc instruction, the form j cc 
can be used. Also, jbsr can be substituted for bsr. In such cases, the assembler decides the 
appropriate size for the instruction. No size suffix is allowed. 

Size Suffixes 

Size suffixes are used in the language to specify the size of the operand in the instruction, 
including addressable locations and registers. All instructions that can operate on more than one 
data size assume the default size of word (16 bits) unless a size suffix is used. Size suffixes can 
also be appended to address register specifications when used in indexed addressing. Operand 
sizes are defined as follows: 


Suffix 

Data Unit 

Bits 

b 

byte 

8 

w 

word 

16 

1 

long 

32 
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Expressions 

Expressions are evaluated in left-to-right order, and parentheses are permitted. Symbols referring 
to defined labels are permitted in expressions. The value of these symbols is their relative value 
within the assembled code. The only operations that can be performed on these symbols are 
addition and subtraction. One label can be subtracted from another, the result being an absolute 
value. A label can be added to an absolute value but not to another symbol. Recognized 
operators include: 


Operator 

Operation 

+ 

Addition 

- 

Subtraction 

* 

Multiplication 

/ 

Division 

% 

Modulus 

I 

Bitwise OR 

& 

Bitwise AND 

- 

Bitwise eXclusive OR 

< 

Shift left 

> 

Shift right 
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Pseudo-Instruction 
Syntax And Semantics 

The following commands are direct instructions to the assembler, and do not result in instruction 
codes to the microprocessor. They are used to create data structures, control program flow 
and form, and support other programming functions that are not directly related to step-by- 
step machine instructions. A complete list of microprocessor commands can be found in the 
microprocessor manual that was shipped with your system. 


align <name>,<modulus> 

asciz ’<string>’ 
bss 

comm <name>,<size> 

data 

dc[.b|.w|.l] 

<expr> I ’ <string> ’[, <expr > | ’ <string> ’] 

ds[.b|.w|.l] <expr> 

equ <expr> 

even 


Create a global symbol of type align. When 
the loader sees this symbol it will create a hole 
beginning at symbol <name> whose size will 
be such that the next symbol will be aligned on 
a < modulus > boundary. 

Put a null terminated <string> into the code at 
this point. 

Put the following assembly into the uninitialized 
data segment. 

Create a global symbol <name>, put it in the 
bss segment with size <size>. 

Place the following assembly in the initialized 
data segment. 

Place the list of expressions <expr> or strings 
<string> into the code at this point. Size suf¬ 
fixes can be used to specify the units of storage 
into which the values will be placed. Default is 
word. In the case of string literals, the amount 
of storage needed will be determined by the as¬ 
sembler and each character will be assigned into 
a unit. 

The units of space are specified by the size suf¬ 
fix. The number of units is determined by the 
expression. 

Assigns the value and attributes of the expres¬ 
sion to the label. 

Forces even word alignment. 
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globl <name>[,<name>]... 


Declares the list of names to be global symbols. 


include “<name>”|<<name>> Specifies a file to be merged into the assembly 

at the point where the instruction is located. 
The file will be searched for according to the 
conventions of C (see cc(l) in the HP-UX Ref¬ 
erence). 

text Place the following assembly in the code seg¬ 

ment. 


Interfacing Assembly Routines 

Effective use of the assembler requires the ability to interface correctly with higher-level languages 
supported on Series 200/300 HP-UX computers. 

Linking 

For a symbol to be known externally, it must be declared in a globl statement. It is not necessary 
that a symbol that has been defined externally be declared within a module; if a referenced symbol 
is not defined within the module, it is assumed to be externally defined. However, it is generally 
recommended that all external symbols be declared in a globl statement, to avoid confusing 
global and local symbols. 
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Calling Conventions 

All languages currently supported on Series 200/300 follow certain conventions with regard to 
subroutine calls. These conventions must be followed correctly in order to call or be called by a 
higher level language. Calling conventions are summarized as follows: 

• Parameters are pushed in reverse order and taken off in the same order as the procedure 
call; 

• The calling routine pops the parameters from the stack upon return; 

• The called routine saves and restores the registers it uses (except dO, dl, aO, al); 

• Function results are generally returned in dO, dl; 

• tst .b required for all stack space used plus that required for the link of any routine called; 
and 

• link/unlk instructions are used to allocate local data space and to reference parameters. 

These conventions are more easily understood when an example is provided. Consider the 
following C program which, in turn, produces assembly language output from the C compiler: 

mainO 

test(1,2); 

} 

test(i,j) 

register int i, j; 

{ 

int k; 
k = i + j; 
return k; 

} 

The resulting Assembly Language output (line numbers have been added on the left side for use 
in the ensuing explanation): 


1 

data 


2 

text 


3 

globl 

_main 

4 

_main 


5 

link 

a6.#-__Fl 

6 

tst .b 

-__Ml-8(a7) 

7 

movem.l 

#__Sl,-__Fl(a6) 

8 

move.1 

#2,-(sp) 

9 

move.1 

#l.-(sp) 

10 

jbsr 

_test 

11 

addq 

#8.sp 

12 

jra 

L12 
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13 

L12 

unlk 

a6 

14 


rts 


15 

__F1 

equ 

0 

16 

__S1 

equ 

0 

17 

__M1 

equ 

0 

18 


data 


19 


text 


20 


globl 

.test 

21 

.test 



22 


link 

a6,#-..F2 

23 


tst .b 

-__M2-8(a7) 

24 


movem.1 

#__S2.-..F2(a6) 

25 


move.1 

8(a6),d7 

26 


move.1 

12 (a6) .d6 

27 


move.1 

d7,d0 

28 


add.l 

d6.d0 

29 


move.1 

d0,-4(a6) 

30 


move.1 

-4(a6).dO 

31 


jra 

L14 

32 


jra 

L14 

33 

L14 

movem.1 

-..F2(a6).#192 

34 


unlk 

a6 

35 


rts 


36 

-_F2 

equ 

12 

37 

__S2 

equ 

192 

38 

-_M2 

equ 

0 

39 


data 



Note that when parameters are pushed by the calling routine (_main), the second parameter is 
pushed first then the first parameter is pushed (lines 8 and 9). When the called routine (.test) 
accesses the parameters (lines 25 and 26), it finds the first parameter first on the stack followed 
by the second parameter (line 25 accesses the first parameter and line 26 accesses the second). 

Also note that the stack is popped upon return from the subroutine (line 11) and not by the 
subroutine itself. Since the called routine makes use of d6 and d7, it pushes those registers on 
the stack (line 24) and then pops them (line 33) before it returns. 

The function result is placed in dO before returning (line 30). Had the function returned a 
double-precision, floating-point number, that number would have been placed in dO and dl. 
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A tst.b instruction (line 23) is needed before any use of stack space by any assembly-language 
routine in order to ensure enough stack space for the routine. If the test fails, the operating 
system can detect the problem and allocate more stack space for the process. If the test is not 
performed, the program may die unnecessarily with a segmentation violation. The minimum 
amount of space that must be specified in the test is the sum of: 

• The amount of space taken by the link instruction; 

• The greatest amount of space used for any parameters that may be pushed; 

• The constant 8 to account for subroutine jumps and the link which that routine may do. 

C and other high-level languages use link and unlk instructions (lines 22, 34) in all routines. The 
link instruction is used to allocate local data space and to allow a constant reference point for 
accessing parameters. The following illustration shows what happens when the link instruction 
on line 22 is executed. 


Before the link: 


After the link: 


8(sp) 

4(sp) 

(sp) 


value of j 


value of i 


return address 


12(a6) 

8(a6) 

4(a6) 

(a6) 

-4(a6) 


value of j 


value of i 


return address 


old (a6) 


value of k 


(sp) 


Note how the parameter i is accessed on line 25. On line 29 the local variable k is set. The link 
instruction is not necessary in assembly language code. If it is not there, however, the routine 
will not show up in a stack backtrace from adb. If a link instruction is included, an unlk must 
be executed before returning. 
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Language Dependencies 
c 

In C, all variables and functions declared by the user are prefixed with an under bar. Thus, a 
variable named test in C would be known as _test at the assembly language level. All global 
variables can be accessed through this name by using a long absolute addressing mode. C always 
pushes a four-byte quantity on the stack for pointers and any form of integer (char, short, long). 
C always pushes eight bytes for a floating-point number (floating-point numbers are converted to 
double-precision). 

Fortran 

Fortran uses the same naming convention as C, and externals can be accessed in the same 
fashion. Fortran always pushes the address of its parameter for user-defined functions. 

Pascal 

In Pascal, any exported user-defined function is prefixed by the module name surrounded by un¬ 
derbars. Thus, for Pascal, a function named funk in module test would be known as _test_funk 
in the resulting assembly-language code. If a procedure is declared as external as in: 

procedure proc; external; 
all calls to proc emit a reference to _proc. 

Global variables are accessed as 32-bit absolute, relative to the global base. The global variable 
il would be accessed as 

move.l test+0x4,d0 
in this example: 

Pascal [Rev 2.1Ma 4/19/83] test.p Page 1 

1:D 0 $list ’test.1’,tables$ 

2:D 0 program test; 

3:D 1 var 

4:D 8 1 il,i2: integer; 

5:D 1 procedure p; 

6:D 2 var 

7:D -42 j: integer; 

8:C 2 begin 

Dump of P 

j var lev= 0d2 addr=-00000004 local 

P dump complete 
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9:C 

10:C 


2 end; 
1 begin 


test 

test 


test proc lev= OdO entry: 00000012 


Dump of TEST 

11 

12 
P 


var lev= Odl addr=00000004 longabs globalbase 
var lev= Odl addr=00000000 longabs globalbase 
proc lev= Odl entry: 00000000 


TEST dump complete 

11 :C 1 end. 

Pascal always pushes a four-byte quantity on the stack for pointers and integers. For a user- 
defined function, any parameter greater than four bytes is passed as an address. 

The HP-UX Reference manual pages for these compilers should be consulted for further informa¬ 
tion. Assembly listings can be generated by C and Fortran, and can be consulted to get valuable 
information. The only current means for looking at the code generated by Pascal is through the 
adb debugger. 


10 
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Conversion From The 
Pascal Language System (PLS) 

A translator (atrans) is provided to assist in converting from PLS assembly language to HP-UX 
assembly language syntax. All code to be ported should be run through the translator first. Lines 
requiring human intervention will be noted by the translator. Tasks performed by the translator 
are explained in the HP-UX Reference^ atrans(l) manual page. 

atrans cannot detect or alter parameter passing conventions that are pushed in reversed order 
on PLS. 

as assumes rorg 0 for all assemblies, as does not generate relative references to external 
symbols; all external references are absolute. As such, code size can increase when being ported 
from PLS to HP-UX. 

as does not support Pascal modules. 

as accepts the same syntax as the PLS assembler for all machine instructions with these excep¬ 
tions: 

Additions: 

• as accepts jcc where cc is a condition code accepted by bcc. In this case, as decides the 
length of the instruction required. 

• as accepts a greater number of operators for expressions. Parentheses are permitted 
within expressions. 

• as accepts an immediate operand for the register list in a movem instruction. Needed for 
compiler. 

• as allows numeric value for displacement as in 12(pc,d6). Needed for compiler. 

• as accepts <digit>$ to specify a local label. 
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Differences: 


• as is a case-sensitive assembler. All opcodes and register names must be listed in lowercase. 

• as accepts (pc) to specify pc-relative references. This is the only way to specify pc-relative. 

• The PLS assembler assumes pc with index in some cases for a parameter of the form 
8(a0). as does not. 

The greatest differences occur in supported pseudo-instructions. The only PLS pseudo-instruc¬ 
tions that are supported are dc, ds, equ, and include. The translator handles some other 
pseudo-instructions, but many will have to be handled by hand. 
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Using HP-HIL Devices 


The Interface to HP-HIL Devices 

This article describes communication with the HP-HIL interface, and other functions provided by 
the HP-HIL peripheral processor (8042). It is primarily a description of the enhancements added 
to handle the HP-HIL interface. This interface is capable of supporting up to seven devices, such 
as graphics input, system ID Module, and other peripherals generally related to human input, as 
well as the system keyboard. 

Before launching into a discussion of the workings of the HP-HIL interface, a general overview 
needs to be presented. HP-HIL stands for “Hewlett-Packard Human Interface Link”. The 
following diagram illustrates the basic components. 



Hewlett-Packard Human Interface Link 
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HP-HIL initialization takes place in the following manner. The peripheral devices in the HP-HIL 
link are powered up when the computer is turned on. Next, because of the “linkback mode” 
each device is recognized by the computer as the “last” device in the link. The “linkback mode” 
is where the computer sends out a signal and the HP-HIL device sends that same signal back to 
the computer through the return side of the device. Each device in the link is checked in this 
manner until there are no additional devices to check in the link. Note that the computer does 
not know the type of each device in the link; it just knows that there is a device at that location 
in the link. 

To further explain the HP-HIL initialization process, the following example is given. Assume the 
computer has sent out a signal, looking for the first device on the link. In our previously shown 
diagram, it would find Device A. Being the first device on the link, it’s address is considered 
to be 1. The computer then instructs Device A to exit linkback mode; that is, send the signals 
through to a possible next device. The computer then attempts to contact the second device 
on the link. Device B responds and is assigned address 2. The computer now knows that there 
are at least two devices on the link. The computer commands Device B to exit linkback mode, 
and attempts to contact the next device. Successful, the computer now knows about Device 
C. As our diagram illustrates. Device C is the last device on the link, so the process proceeds 
differently at this point. 

The computer instructs Device C to exit linkback mode, and attempts to contact (nonexistent) 
Device D. Since it is not there, a timeout occurs, and the computer deduces that Device C is 
the last device on the link. Therefore, it instructs Device C to once again enter linkback mode, 
and the link is configured. 

The link can deal with a maximum of seven devices at any one time (see the Note in the section, 
“A Few HP-HIL Devices”). If there are eight or more devices physically connected, the devices 
after number seven are not found. 

As the above discussion indicates, the address of a particular device is merely its topological 
order of placement along the link. In the above diagram. Device A has address 1, B has address 
2, and C has address 3. This is only a result of their physical order of connection. If Device C 
had been connected between Devices A and B, Device A would still have been address 1, but 
Device C would be address 2, and B would be address 3. The type of device is irrelevant to 
the address assigned to it. 

After the link is operational, and during subsequent link operations, each device looks at the 
data being sent down the link. If a device notices that the destination address associated with 
the link data is the same as that device’s address, that device receives and acts on the data. 
Otherwise, the data is merely shuttled along to the next device. 
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A Few HP-HIL Devices 

This section provides a brief description of a few of the HP-UX supported HP-HIL devices. You 
can make use of these devices by writing special programs to control them in the C Language, 
FORTRAN, or Pascal. 

Before you can use an HP-HIL device, your terminal or computer must meet the following 
requirements: 

• It should have a built-in HP-HIL interface present. This is the case for the HP 150- 
II, HP 150-III, HP Models 217, 237, 310 and 320, Vectra Personal Computer, Integral 
Personal Computer, and Model 550 with an HP 98700H Graphics Display Station. The 
HP 2393 and HP 2397 terminals also have built-in HP-HIL interfaces. 

• If you are using a Model 220, it should have an HP 9920 Option 535 (HP 09920-66535, 
HP-HIL Keyboard/HP-IB Interface) card inserted in its backplane. 

The following is a list of HP-HIL devices supported by the HP-UX system. This list also provides 
the maximum current which each device uses. 


NOTE 

The total current your HP-HIL link can use before it stops working is 
750 milliamps. This current limit is true for all HP-UX computers except 
the Integral PC and HP 98700A/H which have a total current limit of 
520 milliamps. 

When determining the total current used by your HP-HIL link, you should 
note that the current limits listed in this section are maximum current 
limits. The typical current used by each HP-HIL device is approximately 
two-thirds of this value, so when calculating the total current used by 
your HP-HIL link you need to take two-thirds of the sum of the maximum 
current values. 


To determine the total current which your HP-HIL link draws when connected to the HP-HIL 
interface, add up the maximum current used by each device in the link and multiply the result 
by two-thirds. Again use the following list to determine the maximum current each device uses. 
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• HP 35723A (HP-HIL/Touch Bezel) — This module is a screen bezel which is placed over 
the bezel of the HP 35731 (medium resolution black and white monitor) and HP 35741 
(medium resolution color monitor) 12-inch video monitors. It can be programmed to select 
various functions by simply touching the screen. Note that this device is simply a lower 
resolution digitizer. The maximum current this device uses is 200 milliamps. 


• HP 46021A (HP-HIL Keyboard) — This keyboard has alphabetic and numeric keys sim¬ 
ilar to those on a typewriter. Note that this keyboard replaces the HP 46020A keyboard 
and that all of the keys in each key group of the HP 46021A function the same as those 
of the HP^6020A. The key groups you will find on this keyboard are as follows: 

• Character Entry Group — allows alphabetic and numeric characters, as well as 
mathematical and commercial signs to be entered. It also contains data control keys 
such as I Back space | and | Return | . 

• Numeric Group — provides for rapid entry of numeric data. 

• Display Control Group — controls the location of the cursor on the display. 

• Edit Group — allows data to be inserted in and deleted from the display. 

• Function Key Group — provides you with system defined function key labels, as 
well as with user defined function key labels. 

• System Control Group — controls system functions related to display operations, 
such as using the | Stop | key to suspend the display. 

The maximum current this device uses is 100 milliamps. 


• HP 46060A (Two-Button Mouse) — This module is a relative graphics input device for 
some graphics programs. It is commonly used to move the cursor to any position on the 
CRT (display) without using arrow keys or an HP 46083A (Knob). The maximum current 
this device uses is 200 milliamps. 


• HP46080A (Extension Module) — The Extension Module allows you to increase the 
distance between any HP-HIL device by eight feet. Note that the HP-HIL link is capable 
of handling seven addresses and that the Extension Module docs not occupy one of these 
addresses. The maximum current this device uses is 25 milliamps. 
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• HP 46081A (HP-HIL/Audio Extension) — The HP 46081A Module allows a separation 
of 2.4 meters (8 feet) between the host computer and another HP-HIL device. This module 
also contains a speaker. Note that the HP-HIL link is capable of handling seven addresses 
and that the Audio Extension does not occupy one of these address. The maximum 
current that this device uses is 25 milliamps. 

• HP 46082A/B (HP-HIL/Audio Remote Extension) — The HP 46082A Module allows 
a separation of 15 meters (49.2 feet) between the host computer and the graphics display 
station, and the HP 46082B Module allows a separation of 30 meters (98.4 feet). The 
Audio Remote Extension module also contains a speaker. Note that the HP-HIL link is 
capable of handling seven addresses and that the Audio Remote Extension module does 
not occupy one of these address. Each extension is a pair of modules plus a length of 
special link cable and RGB coax cables. The maximum current that each of these devices 
use is 50 milliamps. 

• HP 46083A (Rotary Control Knob) — This module provides the additional feature of a 
rotary control knob to your system. Note that a switch is provided which toggles the knob 
from X-axis data to Y-axis data. The maximum current this device uses is 110 milliamps. 

• HP 46084A (HP-HIL ID Module) — The HP 46084A Module is an HP-HIL device that 
returns an identification number for identifying you as the computer user. The identification 
number is unique to your particular ID Module. This allows application programs to use 
the ID Module to control access to program functions, data bases, and networks. Note 
that the identification number is the product/exchange and serial numbers returned in a 
packed format as explained in the section of this article, “Report Security Code”. The 
maximum current this device uses is 60 milliamps. 

• HP 46085A (Control Dials) — This module provides nine user-definable knobs. These 
knobs can be software defined to provide zooming, panning, rotation, horizontal and vertical 
motion, color translation, and menu control when using graphics. Each knob on the 
HP 46085A can be defined in software to do functions other than those mentioned. Note 
that the HP46085A Module occupies 3 addresses on the link. Each horizontal row 
corresponds to one address (bottom to top). The maximum current this device uses is 
320 milliamps. 
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• HP 46086A (Function Box) — This module provides 32 function keys to select software- 
defined functions. A status LED, which is controlled by software, provides an indication 
of when the device is sending or receiving data. This device uses a non-standard key code 
set (Keycode Set 2) which is shown below. The maximum current this device uses is 80 
milliamps. 


Keycode Set 2 for the Function Box 
(press value/release value) 


8/9 

20/21 

32/33 

44/45 


0/1 

10/11 

22/23 

34/35 

46/47 

56/57 


2/3 

12/13 

24/25 

36/37 

48/49 

58/59 


4/5 

14/15 

26/27 

38/39 

50/51 

60/61 


6/7 

16/17 

28/29 

40/41 

52/53 

61/63 


18/19 

30/31 

42/43 

54/55 


• HP 46087A (A-size Digitizer) — The A-size Digitizer provides the capability to enter 
data from an ISO A4 or ANSI A-size drawing, or free-hand graphics input. It uses either a 
pen-like stylus or optionally an HP 46089A (Four-Button Cursor). The maximum current 
this device uses is 200 milliamps. 


• HP46088A (B-size Digitizer) — The B-size Digitizer provides the capability to enter 
data from an ISO A3 or ANSI B-size drawing, or free-hand graphics input. It uses either a 
pen-like stylus or optionally an HP 46089A (Four-Button Cursor). The maximum current 
this device uses is 200 milliamps. 

• HP 46089A (Four-Button Cursor) — This device is a four switch puck that may be used 
on the A or B-size Digitizer in place of the stylus. This device does not take an address 
space, and it does not use any additional current. 


• HP 46094A (HP-HIL/ Quadrature Port) — This device provides the capability for inter¬ 
facing an off-the-shelf 3 Button Mouse, Trackball or any other device which provides an 
output in quadrature to the HP-HIL link. The maximum current this device uses is 200 
milliamps. 
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• HP 92916A (Bar-Code Reader) — This module reads all standard bar-codes using a 
wand as the input device. It provides you with an effective and reliable alternative to the 
time consuming keyboard for data entry. Note that HP-UX supports this device in the 
keyboard mode, where the input from the device looks like key codes. The key codes which 
can be read by the Bar-Code Reader are: 3 of 9, Interleaved 2 out of 5, UPC/EAN, and 
Codabars USD-4 and ABC. The maximum current this device uses is 200 milliamps. 

For more information on these devices, call your local HP Sales or Service Representatives. 


Using HP-HIL Devices 

This section gives a procedure for creating special (device) files for your HP-HIL devices, provides 
programs for identifying HP-HIL devices, and includes tables for interpreting data for the sample 
programs. This section also includes a discussion of the commands (opcodes) used in the macros 
located in the file /usr/include/sys/hil\oct\.h. 


Note 

HP-HIL devices can be added to or removed from the HP-HIL link with¬ 
out effecting the HP-UX operating system while it is running. However, 
if you are running an application which requires the use of that particular 
device and you: 

• remove the device from the link, or 

• open the link to the device, or 

• open the link to add a new device 

your application might not recognize the change and as a result it will 
not work as expected. An HP-HIL device can be added anywhere in the 
HP-HIL link provided it is not a non-extendable device (e.g. HP 46060A, 
Two-button Mouse), in this case the device can only be added to the end 
of the link. 
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A Few Terms 

The following terms will be used throughout this article: 

• A special (device) file is a file associated with an I/O device. Special (device) files are 
read and written just like “ordinary files” (a type of HP-UX file containing either a program, 
text or data), but requests to read or write result in activation of a driver of the associated 
device. Entries for each file normally reside in the /dev directory. In this article, you will 
find that a special (device) file is referred to as a device file or a special file. 

• A macro is a command which contains a set of instructions to be performed. The term 
macro was derived from the word macroinstruction. 

• A data frame is the way information travels through the HP-HIL link. It consists of 15 
bits of information which include: start (1 bit), stop (1 bit), command (1 bit), parity (1 bit), 
address (3 bits), and data (8 bits). The frame is transmitted around the link at the rate of 
10 micro-seconds per bit, or 150 micro-seconds per frame. 


Bit Format for Data Frame 


start 

address 

command 

opcode/data byte 

parity 

stop 

1 

1 2 3 

1 

1 2 3 4 5 6 7 8 

1 

1 


• A command (opcode) in this article is an operational code used in a lower level pro¬ 
gramming language (assembly) to perform an operation, such as incrementation, inversion 
or multiplication, on one or more operands. This is the definition for the term opcode; 
however, in this article it will be used as the definition for the term command. 

• A path name is a sequence of directories and “ordinary files” (HP-UX files containing either 
programs, text or data) separated by /’s which map out a path leading to a destination 
file. 

• A select code is part of an address used for devices; a number determined by a setting on 
an interface card to which a peripheral device is connected. Multiple peripherals connected 
to the same interface card share the same select code. 
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Creating a Special Device File for HP-HIL Devices 

Each device on the HP-HIL link has a unique address based on its position in the link (e.g. the 
first addressable HP-HIL device is address 1 and so on). To access a device, you must first 
create a special (device) file using the mknod command. The format for using this command is 
as follows: 

/etc/mknod /dev/device_name c XX OxSSOGAO 
where: 

device^name is some name you give to identify the HP-HIL address (e.g. hill) for which 
you are creating a device file. 

c specifies the character mode rather than the block mode. 

XX is the major (driver) number used with the device you are creating. Series 

200/300 computers use major (driver) number 24 for communicating with 
HP-HIL devices. Series 500 computers use major (driver) number 42 for 
communicating with HP-HIL devices. 

SS is the select code of the device. Series 500 uses select code Oxff and Series 

200/300 uses select code 0x00. 

G is the slot number minus 4 (on the Series 500) for the HP 98288 Display Sta¬ 

tion Buffer associated with the HP 98700 Display Station. The slot numbers 
used for the Display Station Buffer on the Series 500 are slots 4 through 7. 
If you inserted your Display Station Buffer in slot 4, the value of G is 0. This 
field is always 0 on the Series 200/300 computers. 

A is the HP-HIL address of the device you wish to talk with. The address ranges 

from one to seven. The first device which can be assigned an address in the 
HP-HIL link gets address number one; the second addressable device gets 
address number two and so on. An addressable device is a device which is 
not an extension device, such as the HP 46080A (Extension Module) and the 
HP 46081A (HP-HIL/Audio Extension). 
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You may need to create a special (device) file for the 8042 driver so you can talk to the timer, 
talk to the beeper, or change the keyboard repeat rate. To do this, use the following form of 
the mknod command: 


/etc/mknod /dev/device_name c XX OxSSOGOO 


device.name is some name you give to identify the HP-HIL address (e.g. rhil) for which 
you are creating a device file. 

c specifies the character mode. 

XX is the major (driver) number used with the device you are creating. Series 

200/300 computers use major (driver) number 23 for communicating with 
the 8042 driver. Series 500 computers use major (driver) number 41 for 
communicating with the 8042 driver. 

SS is the select code of the device. Series 500 uses select code Oxff and Series 

200/300 uses select code 0x00. 

G is the slot number minus 4 (on the Series 500) for the HP 98288 Display Sta¬ 

tion Buffer associated with the HP 98700 Display Station. The slot numbers 
used for the Display Station Buffer on the Series 500 are slots 4 through 7. 
If you inserted your Display Station Buffer in slot 4, the value of G is 0. This 
field is always 0 on the Series 200/300 computers. 

Additional Considerations 

When you execute a long listing of the /dev file, you will find that the device files for HP-HIL 

devices on Series 200/300 computer are as follows: 


crw-rw-rw“ 

1 

root 

root 

24 

0x000010 

Oct 

29 

09:02 

hill 

crw-rw-rw- 

2 

root 

root 

24 

0x000020 

May 

22 

1985 

hil2 

crw-rw-rw- 

1 

root 

root 

24 

0x000030 

May 

22 

1985 

hil3 

crw-rw-rw- 

1 

root 

root 

24 

0x000040 

May 

22 

1985 

hil4 

crw-rw-rw- 

1 

root 

root 

24 

0x000050 

May 

22 

1985 

hil5 

crw-rw-rw- 

1 

root 

root 

24 

0x000060 

May 

22 

1,985 

hil6 

crw-rw-rw- 

1 

root 

root 

24 

0x000070 

May 

22 

1985 

hil7 

crw-rw-rw- 

1 

root 

root 

25 

0x000080 

May 

22 

1985 

hilkbd 
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Device files for HP-HIL devices on Series 500 computers are listed as follows: 


crw-rw-rw- 1 
crw-rw-rw- 2 
crw-rw-rw- 1 
crw-rw-rw- 1 
crw-rw-rw- 1 
crw-rw-rw- 1 
crw-rw-rw- 1 
crw-rw-rw- 1 


root 

root 

root 

root 

root 

root 

root 

root 

root 

root 

root 

root 

root 

root 

root 

root 


42 OxffOOlO Oct 
42 0xff0020 May 
42 OxffOOSO May 
42 0xff0040 May 
42 OxffOOBO May 
42 OxffOOeO May 

42 0xff0070 May 

43 OxffOOBO May 


29 09:02 hill 
22 1985 hil2 

22 1985 hil3 

22 1985 hil4 

22 1985 hil5 

22 1985 hil6 

22 1985 hil7 

22 1985 hilkbd 


Note that the last device file (hilkdb) listed has a different major (driver) number. This is the 
device file for the HP-HIL “cooked” keyboard driver. The HP-HIL “cooked” keyboard driver 
does not require a new keyboard; it simply provides a protocol conversion for using your present 
HP-HIL keyboard. This protocol only recognizes the down stroke of a key when it is pressed 
(not both up and down keystrokes). Using this protocol conversion with programs that trap 
individual keystrokes (by reading from the HP-HIL interface) makes the application programs 
more compact, because they are keeping track of fewer keystrokes. 

Note that the keyboard sends a set of data which consist of a four byte time stamp, one byte 
that contains status information as follows: 

• lOOOxxxx — both I Shift | and | CTRL | have been pressed, 

• lOOlxxxx — only | CTRL | has been pressed, 

• lOlOxxxx — only | Shift | has been pressed, 

• lOllxxxx — I Shift I and | CTRL | have not been pressed, 

and a final byte that contains a key code taken from the table below. The following is a table of 
the keycodes for the HP-HIL “cooked” keyboard driver. 
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Kcycodcs for the HP-HIL “Cooked” Keyboard Driver (continued) 


Keycodes in 

Key Label 

hex 

decimal 

Unshifted 

Shift 

IB 

27 



1C 

28 



ID 

29 

QU 


IE 

30 

d] 


IF 

31 



20 

32 

Q3] 


21 

33 

[1] 


22 

34 

m 


23 

35 

s 


24 

36 

d] 


25 

37 

Unused 


26 

38 

H 


27 

39 

H 


28 

40 

1 Insert line | 


29 

41 

1 Delete line 1 


2A 

42 

Unused 


2B 

43 

1 Insert char | 


2C 

44 

1 Delete char 1 


2D 

45 

Unused 


2E 

46 

1 Back space | 


2F 

47 

Unused 


30 

48 

Unused 


31 

49 

Unused 


32 

50 

Unused 


33 

51 

Unused 


34 

52 

Unused 


35 

53 

Unused 
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Keycodes for the HP-HIL “Cooked” Keyboard Driver (continued) 


Keycodes in 

Key Label 

hex 

decimal 

Unshifted 

Shift 

36 

54 

Unused 


37 

55 

Unused 


38 

56 

Unused 


39 

57 

1 Enter | 


3A 

58 

Unused 


3B 

59 

Unused 


3C 

60 

m" 


3D 

61 

CT 


3E 

62 

CT 


3F 

63 



40 

64 



41 

65 



42 

66 



43 

67 



44 

68 



45 

69 

m" 


46 

70 

m" 


47 

71 

m" 


48 

72 

m" 


49 

73 

m" 


4A 

74 

m" 


4B 

75 

CZP 


4C 

76 

Unused 


4D 

77 

Unused 


4E 

78 

Unused 


4F 

79 

Unused 


50 

80 

m 

m 

51 

81 

ci: 

1 @ 1 


^ Numeric keypad key. 
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Keycodes in 



52 82 [XI 

53 83 [XI 

54 84 XI 

55 85 X 

56 86 X 

57 87 X 

58 88 X 

59 89 X 

5A 90 □ 

5B 91 X 

5C 92 [Xl 

5D 93 [T) 

5E 94 Xl 

5F 95 X 

60 96 X 

61 97 X 

62 98 X 

63 99 (Space) 

64 100 CXI 

65 101 X 

66 102 X 

67 103 X 

68 104 CX 

69 105 [wj 

6A 106 X 

6B 107 X 

6C 108 X 

6D 109 X 

6E 110 X 


000QQ000Q0000QBB0 












Keycodes for the HP-HIL “Cooked” Keyboard Driver (continued) 


Keycodes in 

Key Label 

hex 

decimal 

Unshifted 

Shift 

6F 

111 

m 


70 

112 

m 


71 

113 

[sj 


72 

114 

m 


73 

115 

m 


74 

116 



75 

117 

CKl 


76 

118 

m 


77 

119 

nri 


78 

120 

m 


79 

121 



7A 

122 

[c] 


7B 

123 

m 


7C 

124 

m 


7D 

125 

nn 


7E 

126 

Unused 


7F 

127 

Unused 



Communicating with HP-HIL Devices 

This section provides sample programs which can be used to identify and describe all of the 
HP-HIL devices supported by HP-UX and it explains the data read by the programs. 

In order to use the programs in this section , you need to type them in using the ui editor or 
HP-UX editor of your choice (the line numbers are not part of the program). Next, compile the 
programs using either the C Language compiler command cc, the FORTRAN compiler command 
/c, or the Pascal compiler command pc. Finally type the file name a.out and press the | Return | 
key. The programs will return the device status and 5 hexadecimal values of the Describe 
Record. They next wait for you to move the Two-Button Mouse around on your desk or type 
in something from the HP 46021A keyboard before returning any data. Note that this same 
process and programs may be used to test all the HP-HIL devices supported on the HP-UX 
operating system. 
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Sample C Language Program 

The sample program covered in this section is used to open a link to the device located at link 
address 1, it requests that an Identify and Describe be performed on the device, reads some 
data, and then closes the link to the device. To communicate with an HP-HIL device from the 
C Language, these intrinsics are used: open, close, read, and iocti 
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1 #include <sys/hilioctl.h> 

2 mainO 

3 { 

4 int fd, status, index, bytes_read, done; 

5 unsigned char describe [11], buffer[10] 

6 

7 /*0pen the device file for the first device on the link.*/ 

8 

9 fd = open("/dev/hill", 0); 

10 

11 for (index = 0; index < 12; index++) 

12 { 

13 describe[index] = ’ '; 

14 > 

15 

16 /*This ioctl system call requests a describe record from 

17 the device. The describe record contains information 

18 describing the amount and types of data that can be 

19 returned by the device.*/ 

20 

21 status = ioctl(fd, HILID, fedescribe[0]); 

22 printf("status '/d \n",status); 

23 printf("describe record\n"); 

24 

25 for (index=0; index<12; index++) 

26 { 

27 printf (" “/oxXn", describe [index]) ; 

28 } 

29 printf("\n", ’ ’); 

30 

31 /*Read at least 21 bytes of data from the device.*/ 

32 

33 done = 0; 

34 while (done < 21) 

35 { 

36 bytes_read = read(fd, buffer, 1); 

37 done += bytes_read; 

38 

39 for (index = 0; index < bytes_read; index++) 

40 { 

41 printf (" yox\n", buff er [index]) ; 

42 > 

43 } 

44 close(fd); 

45 } 
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The following is an explanation of the program: 


Line 1 provides the include file (sys/hilioctl .h) which contains a list of macros that execute 
specific functions when used within a C program. The HILID macro (line 21) which is called in 
the above program executes the identify and describe function. Note that the macro HILID can 
be found in the file hilioctih. The path name for the hilioctih file is /usr/include/s\;s/hilioctl.h. 
If you execute the cat or more command on this path name, you will receive a screen listing of 
this file’s contents. 

Lines 4 and 5 declare the variables to be used in the program. 

Line 9 opens the file /dev/hill for reading. 

Lines 11 through 14 initialize the describe array. 

Line 21 uses the system call ioctl to call the macro HILID which when executed returns a 
describe array in the argument describe [0] . A function return value is assigned to the variable 
status. 

Line 22 prints the value for status and Line 23 prints the column header for the describe 
record listing. 

Lines 25 through 28 are a for link which list the contents of the describe array. The contents 
listed are the device ID, the describe record header, and the I/O descriptor byte. 

Line 29 prints a blank and executes a carriage return. 

Line 33 initializes the variable done. 

Lines 34 through 43 are a while link which reads 21 bytes of data from the the device one byte 
at a time and then list this data on the standard output (CRT). The data returned is the number 
of bytes in each packet, a time stamp, and a poll record header and it’s parameters. 

Line 44 closes the file /dev/hill. 
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The results of using this program to read data from a Two-Button Mouse are similar to: 

status 0 
describe record 
68 
12 
C2 
IE 
2 
0 
0 
0 
0 
0 
0 
0 

8 

2 

82 

D9 

D3 

2 

1 

0 

8 

2 

82 

D9 

DB 

2 

1 

1 

8 

2 

82 

D9 

DD 


An explanation for these results can be found in the section of this article entitled, “Description 
of the Data Returned by the Programs”. 
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Sample Pascal Program 

The sample programs covered in this section arc used to open a link to the device located at 
link address 1, they requests that an Identify and Describe be performed on the device, read 
some data, and then close the link to the device. To communicate with an HP-HIL device from 
Pascal, the HP-HIL device file is opened by executing a Pascal RESET. There is also the need 
to use the Pascal ALIAS directive to make function and procedure calls to the C Language 
commands: iocti and sprintf. Other Pascal directives used are: $standard_level ’HP_MODCAL’$ 
and $type_coercion ’NONCOMPATIBLE’$ for the Series 500 Pascal program only and 
$sysprog on$ for the Series 200/300 program only. 

The differences in the two programs provided in this section are in the directives used and the 
preappending of the underscore to Series 200/300 ALIAS command calls. 
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Series 200/300 Program Listing 


1 $sysprog on$ 

2 

3 program hildev (input, output); 

4 

5 const 

6 maxstr = 255; 

7 maxdes = 12; 

8 loopcount = 21; 

9 hil.id = 1074554883; 

10 format = ’ %X’#0; 

11 

12 type 

13 anyStr = packed array [1..maxstr] of char; 

14 des_array = packed array[ 1..maxdes ] of char; 

15 


16 var 

17 device.f 

18 buf 

19 describe 

20 index, status 

21 format_str 

22 line 

23 


file of char; 
char; 

des_array; 
integer; 

packed array[ 1..8] of char; 
anystr; 


24 function ioctl $alias *_ioctl’$ (fd, hilid : integer; 

25 var des ; des_array): integer; external; 

26 
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27 procedure sprintf $alias ’_sprintf’$ (anyvar str, format : anystr; 

28 num : integer); external; 

29 

30 begin 

31 (*0pen the device file for the first device on the link.*) 

32 

33 reset (device_f, Vdev/hillO; 

34 for index := 1 to maxdes do describe[index] := chr(O); 

35 format_str := format; 

36 

37 (*This ioctl system call requests a describe record from 

38 the device. The describe record contains information 

39 describing the amount and types of data that can be 

40 returned by the device.*) 

41 

42 status := ioctl(3, hil_id, describe); 

43 writeln (’status = status:2); 

44 writeln (’describe record’); 

45 for index := 1 to maxdes do 

46 begin 

47 sprintf (line, format_str, ord(describe[index])); 

48 writeln (line); 

49 end; 

50 writeln; 

51 

52 (*Read at least 21 bytes of data from the device.*) 

53 

54 index := 0; 

55 while index < loopcount do 

56 begin 

57 read (device_f, buf); 

58 sprintf (line, format_str, ord(buf)); 

59 writeln (line); 

60 index := index + 1; 

61 end; 

62 close(device_f); 

63 end. 
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Scries 500 Program Listing 


1 $standard_level ’HP_M0DCAL*$ 

2 $type_coercion ’NONCOMPATIBLE 

3 program hildev (input, output); 

4 


5 const 

6 maxstr = 255; 

7 maxdes = 12; 

8 loopcount = 21; 

9 hil^id = 1074554883; 

10 format = ’ yoX*#0; 

11 

12 type 

13 anystr = packed array [1..maxstr] of char; 

14 des_array = packed array[ 1..maxdes ] of char; 

15 


16 var 

17 device.f 

18 buf 

19 describe 

20 index, status 

21 format.str 

22 line 

23 


file of char; 
char; 

des_array; 
integer; 

packed array[ 1..8] of char; 
anystr; 


24 function ioctl $alias "ioctl’$ (fd, hilid : integer; 

25 var des : des_array): integer; external 

26 
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27 procedure sprintf $alias ’sprintf’$ (anyvar str, format : anystr; 

28 num : integer); external; 

29 

30 begin 

31 (*0pen the device file for the first device on the link.*) 

32 

33 reset (device.f, ’/dev/hill’); 

34 for index := 1 to maxdes do describe[index] := chr(O); 

35 format_str := format; 

36 

37 (*This ioctl system call requests a describe record from 

38 the device. The describe record contains information 

39 describing the amount and types of data that can be 

40 returned by the device.*) 

41 

42 status := ioctl(3, hil_id, describe); 

43 writeln (’status = status:2); 

44 writeln (’describe record’); 

45 for index := 1 to maxdes do 

46 begin 

47 sprintf (line, format.str, ord(describe[index])); 

48 writeln (line); 

49 end; 

50 writeln; 

51 

52 (*Read at least 21 bytes of data from the device.*) 

53 

54 index := 0; 

55 while index < loopcount do 

56 begin 

57 read (device_f, buf); 

58 sprintf (line, format_str, ord(buf)); 

59 writeln (line); 

60 index := index + 1; 

61 end; 

62 close(device_f); 

63 end. 

The following is an explanation of the program: 

Line 1 $sysprog on$ is the Series 200 Pascal directive which allows you to use ANYVAR. The 
ANYVAR parameter specifier in a function or procedure relaxes type compatibility checking when 
the routine is called. The Series 500 directives which allow you to do this are $standard_level$ 
and $type_coercion$. 
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Lines 5 through 10 are the constants defined as follows: 

• maxstr is the maximum string length for a packed array of characters. 

• maxdes is the maximum string length for a packed array of characters containing the 
describe record. 

• loopcount is the number of times the while link of lines 55 through 61 is to be executed. 

• hil_id is the decimal value of the HILID command. The decimal values for the other 
HP-HIL commands can be found in a table in the section, “Identify and Describe Com¬ 
mand (HILID)”. Note that it is only necessary to use these decimal values of the HP-HIL 
commands when using the FORTRAN and Pascal programming languages. 

• format is the character string used to format the output of the sprintf command. Note 
that #0 is the end of line character in Pascal. 

Lines 13 through 14 are the type declarations for the program. They are defined as follows: 

• any St r is a packed array of characters. This packed array of characters is used to declare 
the variables line, str, and format. 

• des_array is the packed array of characters used to declare the variable describe. 

Lines 17 through 22 are a list of the variables declared for this program. They are defined as 
follows: 

• device.f is the file name assigned to the device file /dev/Ml. 

• buf is the character variable returned from reading the device_f file. 

• describe is the packed array of characters which is assigned the describe record. The 
describe record is explained in the section, “Identify and Describe Command (HILID)”. 

• index is a link control variable. 

• status is the variable which is assigned the status of the opened file device.f (/dev/hi 11) 
after executing the HILID command. 

• format_str is the packed array of characters assigned the value of the constant called 

format (’ y,X’#0). 

• line is the packed array of characters that is assigned the value of the character string 
that is returned when the sprintf command is executed. 
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Line 24 is a function which references the external HP-UX command ioctl Note that the string 
parameter in the ALIAS directive has an under score preappended to it. This is only true for 
Series 200/300 computers. 

Line 27 is a procedure which references the external HP-UX command sprintf. Note that the 
string parameter in the ALIAS directive has an under score preappended to it. This is only true 
for Series 200/300 computers. 

Line 33 opens the device file /dev/hill and assigns it the name device^f. 

Line 34 initializes the packed array describe. 

Line 35 assigns the constant format to the packed array of characters format.str. 

Line 42 executes the function ioctl and assigns its status value to the variable status. 

Line 43 causes the variable status to be output to the display. 

Line 44 outputs the describe record label. 

Lines 45 through 49 are a for link which causes the describe record to be sent to the display 
or standard output (CRT). 

Line 54 initializes the count variable index to zero. 

Lines 55 through 61 are a while link which causes the data read from the device file device_f 
to be sent to the display (CRT). 

Line 62 closes the device file device.f. 
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The results from using this program to read data from a Two-Button Mouse are similar to: 


status 0 
describe record 
68 
12 
C2 
IE 
2 
0 
0 
0 
0 
0 
0 
0 

8 

2 

82 

D9 

D3 

2 

1 

0 

8 

2 

82 

D9 

DB 

2 

1 

1 

8 

2 

82 

D9 

DD 

An explanation for these results can be found in the section of this article entitled, “Description 
of the Data Returned by the Programs”. 
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Sample FORTRAN Program 

The sample program covered in this section is used to open a link to the device located at link 
address 1, it requests an identify and describe be performed on the device, reads some data, 
and then closes the link to the device. To communicate with an HP-HIL device from FORTRAN, 
the HP-HIL device file is opened by executing a FORTRAN OPEN statement. There is also the 
need to use the FORTRAN ALIAS directive to make calls to the C Language commands: ioctl 
and read. 


The program is as follows: 


$alias 

$alias 


1 
2 

3 

4 

5 

6 

7 

8 
9 

10 C 

11 
12 

13 

14 

15 

16 

17 

18 

19 

20 100 
21 110 
22 

23 

24 

25 

26 

27 

28 
29 


program hildev 

ioctl=’ioctl ’ (y.val //oval .Voref) 

read= ’ read ’ (Voval, 7oref , y,val) 

integer fd, istatus, index, HILID, count 

parameter (HILID = 1074554883) 

character*12 describe 

character*! chi 

open(unit=10,file="/dev/hill") 
fd=fnum(10) 

count = 0 
do index = 1, 12 

describe(index:index) = * ’ 
end do 

istatus=ioctl(fd,HILID,describe) 
print*,"status = ",istatus 
print*,"describe record" 
do 110 index = 1,12 

write(6,100) describe(index:index) 
format(’ ’,6X,Z2.1) 
continue 
write(6,’() 0 

do while (count .LT. 21) 
call read (fd, chi, 1) 
write(6,’(7X,Z2.1)’) chi 
count = count + 1 
end do 
end 


open for first hil device 
get the file descriptor 
for unit 10 (/dev/hill) 
initialize count variable 
initialize character array 
describe 

check the status 
output the status 
label describe record 


output the describe 
record 


! read 21 bytes of data 
! from the device 


The following is an explanation of the program: 


Line 1 is the program statement which defines the the name of the program. The program 
name for this program is hildev. 
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Lines 2 and 3 are ALIAS directives used to assign internal function names to the external HP-UX 
commands iocti and read. 

Line 4 declares the variables contained in it to be integers. These variables are defined as 
follows: 

• fd is file descriptor associated with unit number 10. 

• istatus is the variable assigned the status value returned by the iocti command. 

• index is the control variable for the DO link in lines 18 through 21 of the program. 

• HILID is the variable associated with the Identify and Describe Command. This variable 
is assigned the value shown in the PARAMETER statement of line 5. The decimal code 
values for the various HP-HIL commands can be found in the section of this article entitled, 
“Identify and Describe Command (HILID)”. 

• count is the count variable for the DO WHILE link of lines 23 through 27. 

Lines 6 and 7 are character variables defined as follows: 

• describe is a string of characters twelve characters long. This variable is assigned the 
describe record when the iocti function is called. 

• chi is a one character string. This variable is assigned the data received when a call to 
the read command is made in the DO WHILE link of lines 23 through 27. 

Line 8 opens the device file /dev/Ml. 

Line 9 assigns the value of unit number 10 to fd. 

Line 11 initializes the count variable to zero. 

Lines 12 through 14 form a DO link which initializes each character of describe to blank. 
Line 15 assigns the value of the iocti function call to the variable istatus. 

Line 16 displays the value assigned to istatus on the standard output (CRT). 

Line 17 displays the describe record label on the standard output. 

Lines 18 through 21 display the contents of the character string describe on the standard 
output. 

Lines 24 through 28 read the data from the device file /dev/Ml and display it on the standard 
output. 
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The results from using this program to read data from a Two-Button Mouse are similar to: 

status 0 
describe record 
68 
12 
C2 
IE 
2 

0 

0 

0 

0 

0 

0 

0 

8 

2 

82 

D9 

D3 

2 

1 

0 

8 

2 

82 

D9 

DB 

2 

1 

1 

8 

2 

82 

D9 

DD 

An explanation for these results can be found in the section of this article entitled, “Description 
of the Data Returned by the Programs”. 
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Description of the Data Returned by the Programs 

This section of the article provides you with an interpretation of the data obtained from running 
any one of the previously discussed programs. To understand how to interpret the Identify and 
Describe Command data returned by these programs, read the section of this article entitled, 
“Identify and Describe Command (HILID)”. 

If you used the previously discussed programs to identify and describe an HP 46060A (Two- 
button Mouse), the first set of data returned to you is created by lines 21 through 29 of the 
C language program, 41 through 48 of the Pascal program (42 through 49 for the Series 500 
Pascal program) , and 15 through 21 of the FORTRAN program. The data looks similar to the 
following: 

status 0 
describe record 
68 
12 
c2 
le 
2 
0 
0 
0 
0 
0 
0 
0 

where the status returned is 0 which indicates that you can communicate with the HP-HIL 
device. If you receive a -1, it means you are not able to communicate with the HP-HIL device. 
The remaining data created by the for link of lines 25 through 28 is explained as follows: 

68 is the device ID for an HP 46060A (Two-button Mouse). 

12 is the describe record header which supplies some of the parameters of the device and 
provides an indication of how much additional information is to follow this parameter. 
The 8 bit character string for the hexadecimal value 12 is: 00010010. Reading this bit 
string from right to left you find that bit 0 is 0 and bit 1 is 1. This says that the header 
uses 16 bits to describe the resolution of the device, and axes X and Y will be reported. 
Bit 4 is set because the I/O descriptor byte is to appear later on in the Describe Record. 

c2 is the lower-byte resolution. 

le is the higher-byte resolution. To determine the total counts per meter multiply the higher 
byte by 256 and add the result to the lower byte read above. Your total counts per 
meter reading should be 7 874. 
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2 is the I/O descriptor byte. The 2 reading indicates the buttons for which the device 
reports key codes. The data here indicates that keycodes are reported for buttons one 
and two. 

Note that the zeros following the I/O descriptor byte (2) do not provide any information. In the 
case of the FORTRAN sample program blanks were returned. These zeros and blanks fill in 
the data locations of the remaining seven empty bytes of data which may be obtained from the 
Identify and Describe Command depending on the device file you are reading. The Identify and 
Describe Command can return up to 12 bytes of data. These 12 bytes of data are as follows: 


Device ID byte 

Describe Record Header 

Number of counts per centimeter (meter) low byte 

Number of counts per centimeter (meter) high byte 

Maximum count of X-axis low byte 

Maximum count of X-axis high byte 

Maximum count of Y-axis low byte 

Maximum count of Y-axis high byte 

Maximum count of Z-axis low byte 

Maximum count of Z-axis high byte 

I/O descriptor byte 

Identify and describe command 


The interpretation of these bytes of data can be found in the section, “Identify and Describe 
Command” in this article. 
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The second set of data received from the previously mentioned program looks similar to the 
following display. Note that leading zeroes of the two digit hexadecimal values have been omitted. 


8 

2 

82 

D9 

D3 

2 

1 

0 

8 

2 

82 

D9 

DB 

2 

1 

1 

8 

82 

D9 

DD 
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where: 

8 is the number of bytes contained in the packet which was read including the 

length byte. Eight bytes of data were read in this packet. 

2 82 D9 D3 is a time stamp in tens of milliseconds since power-up. The time stamp since 
power-up for this packet of data is 42 129 875 milliseconds. 

2 is the poll record header. This header indicates to the System the type and 

quantity of information to follow, as well as reporting simple status information. 
The 8 bit character string for the hexadecimal value of 02 is: 00000010. This 
shows bit 0 is 0 and bit 1 is 1, which indicates that the coordinate axes the 
device is reporting are: X and Y. 

1 is the X coordinate relative position of 1. Note that this reading is how much 
the X coordinate has moved since the last poll. 

0 is the Y coordinate relative position of zero (0). Note that this reading is how 

much the Y coordinate has moved since the last poll variable. 

8 is the number of bytes in the second packet of data sent. Eight bytes of data 

were read in this packet. 

2 82 D9 DB is a time stamp in tens of milliseconds since power-up. The time stamp since 

power-up for this packet of data is 42 129 883 milliseconds. 

2 is the poll record header. This header indicates to the System the type and 

quantity of information to follow, as well as it reports simple status information. 
The 8 bit character string for the hexadecimal value of 02 is: 00000010. This 
shows bit 0 is 0 and bit 1 is 1, which indicates that the coordinate axes the 
device is reporting are: X and Y. 

0 is the X coordinate position of one (1). 

1 is the Y coordinate position of one (1). 

8 is the number of bytes in the second packet of data sent. Eight bytes of data 

were read in this packet. 

2 82 D9 DD is a time stamp in tens of milliseconds since power-up. The time stamp since 

power-up for this packet of data is 42 129 885 milliseconds. 

The last three bytes of data that were not shown in the previous data listing were truncated by 
the program. These bytes of data if read would return the Poll Record Header, X-axis coordinate 
position and the Y-axis coordinate position. 
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If you were using an HP 46021A (Keyboard) instead of an HP 46060A (Two-button Mouse), 
then the second set of data read from the device would look similar to the following display. 
Note that leading zeroes of the two digit hexadecimal values have been omitted. It should also 
be noted that the describe record header returned for the HP 46021A is the hexadecimal value 
DF, which indicates that it is an Extended Keyboard. The trailing zeros again should be ignored, 
as they do not provide any information. 

7 

A2 

7D 

37 

B6 

40 

F2 

7 

A2 

7D 

37 

BA 

40 

F3 

7 

A2 

7D 

49 

20 

40 

F2 

where: 

7 is the number of bytes contained in the packet which was read. Seven bytes of 

data were read in this packet. 

A2 7D 37 B6 is a time stamp in tens of milliseconds since power-up. The time stamp since 
power-up for this packet of data is 2 726 115 254 milliseconds (A2 7D37B6 
hexadecimal = 2 726 115 254 decimal). 

40 is the poll record header. This header indicates to the system the type and 

quantity of information to follow, as well as reporting simple status information. 
The 8 bit character string for the hexadecimal value of 40 is: 0100 0000. Bit 
6 is 1 (rightmost bit is bit 0), which indicates that the information read is up to 
8 bytes and that the data produced can be interpreted by using Keycode Set 1 
(Keycode Set 1 is provided at the end of this article). 

f 2 is the space bar key which has been pressed down. 
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7 is the number of bytes contained in the second packet which was read. Seven 

bytes of data were read in this packet. 

A2 7D 37 BA is a time stamp in tens of milliseconds since power-up. The time stamp since 
power-up for this packet of data is 2 726 115 258 milliseconds (A2 7D 37 BA 
hexadecimal = 2 726 115 258 decimal). 

40 is the poll record header. This header indicates to the system the type and 

quantity of information to follow, as well as reporting simple status information. 
The 8 bit character string for the hexadecimal value of 40 is: 0100 0000. Bit 
6 is 1 (rightmost bit is bit 0), which indicates that the information read is up to 
8 bytes and that the data produced can be interpreted by using Keycode Set 1 
(Keycode Set 1 is provided at the end of this article). 

f3 is the space bar key which has been released. 

7 is the number of bytes contained in the packet which was read. Seven bytes of 

data were read in this packet. 

A2 7D 49 20 is a time stamp in tens of milliseconds since power-up. The time stamp since 
power-up for this packet of data is 2726119712 milliseconds (A2 7D 49 20 
hexadecimal = 2726119712 decimal). 

40 is the poll record header. This header indicates to the system the type and 

quantity of information to follow, as well as reporting simple status information. 
The 8 bit character string for the hexadecimal value of 40 is: 0100 0000. Bit 
6 is 1 (rightmost bit is bit 0), which indicates that the information read is up to 
8 bytes and that the data produced can be interpreted by using Keycode Set 1 
(Keycode Set 1 is provided at the end of this article). 

f 2 is the space bar key which has been pressed down. 
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HP-HIL Commands 

This section contains a descriptions of the various HP-HIL commands (opcodes), including their 
usage, effects, and format when transmitted and received. Note that the term command as it 
relates to opcode in this article is explained in the section, “A Few Terms”. The commands 
covered in this section are used within the macros located in the file /usr/include/sps/hilioctl.h. 
As stated earlier these macros are called by using them as parameters in an ioctl command. For 
example: 

ioctl(fd, HILID, &describe[0]) 

The following is a table of the macros included in the file /usr/include/sys/hi\ioct\.h. This table 
contains the hexadecimal commands (opcodes) for these macros, as well as a brief description 
of each macro. A detailed description of the commands is provided in the sections which follow 
this table. 


HP-HIL Macros 


Macro 

Opcode 

(hexadecimal) 

Description 

HILID 

03h 

Identify and Describe 

HILPST 

05h 

Perform Self Test 

HILRR 

06h 

Read Register 

HILWR 

07h 

Write Register 

HILRN 

30h 

Report Name 

HILRS 

31h 

Report Status 

HILED 

32h 

Extended Describe 

HILSC 

33h 

Report Security Code 

HILDKR 

3Dh 

Disable Keyswitch Auto Repeat 

HILERl 

3Eh 

Enable Keyswitch Auto Repeat, cursor key repeat rate 
= 1/30 second. This is based on a system poll rate of 
1/60 second. 

HILER2 

3Fh 

Enable Keyswitch Auto Repeat, cursor key repeat rate 
= 1 /60 second. This is based on a system poll rate of 
1/60 second. 

HILP1..HILP7 

40h..46h 

Prompt 1 through Prompt 7 

HILP 

47h 

Prompt (General Purpose) 

HILA1..HILA7 

48h..4Eh 

Acknowledge 1 through Acknowledge 7 

HILA 

4Fh 

Acknowledge (General Purpose) 
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The macro names on the previous page cannot be used directly as parameters for an ioctl system 
call from Pascal or FORTRAN. However, if you assign the decimal value of the code to a declared 
integer variable and then use it as a parameter to an ioctl command, you can use the macro 
within a Pascal or FORTRAN program. The following table provides you with a listing of these 
macros in their decimal form. 

HP-HIL Macros and Their Decimal Equivalent 


Macros 

Decimal Equivalent 

HILID 

1074554883 

HILPST 

1073833989 

HILRR 

-1073649658 

HILWR 

-2147391481 

HILRN 

1074817072 

HILRS 

1074817073 

HILED 

1074817074 

HILSC 

1074817075 

HILDKR 

-2147456963 

HILERl 

-2147456962 

HILER2 

-2147456961 

HILPl 

-2147456960 

HILP2 

-2147456959 

HILP3 

-2147456958 

HILP4 

-2147456957 

HILP5 

-2147456956 

HILP6 

-2147456955 

HILP7 

-2147456954 

HILP 

-2147456953 

HILAl 

-2147456952 

HILA2 

-2147456951 

HILA3 

-2147456950 

HILA4 

-2147456949 

HILA5 

-2147456948 

HILA6 

-2147456947 

HILA7 

-2147456946 

HILA 

-2147456945 
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Identify and Describe Command (HIUD) 

This command is used to determine the type of devices that are connected to the HP-HIL link, 
as well as the characteristics of these devices. Each device responds to the Identify and Describe 
command with a series of data bytes which are referred to as the Identify and Describe Record. 

The Identify and Describe Record varies in length from 2 to 11 bytes. This record contains the 
following data format: 

• Device ID Byte, 

• Describe Record Header, 

• I/O Descriptor Byte. 

The remainder of this section will cover how to interpret each segment of the Identify and 
Describe Record. 
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Device ID Byte — is used to identify the general class of device and its nationality in the case 
of a keyboard or keypad. Since the sample program in this appendix only returns a two digit 
hexadecimal value as a device ID, you need a table which can be used to interpret what this 
value means. The following is a table of HP-HIL devices and the hexadecimal values which 
correspond to these devices. 


HP-HIL Device Identification Codes 


Device Type 

ID Range (hex) 

Device Description 


E0...FFh 

Standard Keyboard (85-87 keys) 

Keyboard 

C0...DFh 

Extended Keyboard (107-109 keys) 


A0...BFh 

Compressed Keyboard (91-93 keys) 


98...9Fh 

Undefined 


90...97h 

Graphics Tablet and Digitizer 

Absolute 

8C...8Fh 

Touchscreen 

Positioners 

88...8Bh 

Touch-pad 


80...87h 

Undefined 


70...7Fh 

Undefined 

Relative 

6C...6Fh 

Undefined 

Positioners 

68...6Bh 

Mouse 


60...67h 

Generic Quadrature Devices (e.g. 
Control Dials, Quad Port, etc.) 


5C...5Fh 

Barcode Reader 

Character 

50...5Bh 

Undefined 

Entry 

40...4Fh 

Undefined 


30...3Fh 

32-button Module and ID Module 

Other 

2C,..2Fh 

Undefined 


20...2Bh 

Undefined 
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If the HP-HIL device you are using with the sample program is a keyboard or keypad, then you 
can to use the following table to determine its nationality. 


HP-HIL Keyboard Nationality Codes 


Lower 5 bits of 
Device ID (hex) 

Nationality of 
Keyboard or Keypad 

00...02h 

Undefined 

03h 

Swiss/French 

o 

b 

o^ 

Undefined 

07h 

Canadian/English 

08...0Ah 

Undefined 

OBh 

Italian 

OCh 

Undefined 

ODh 

Dutch 

OEh 

Swedish 

OFh 

German 

10...12h 

Undefined 

13h 

Spanish 

14h 

Undefined 

15h 

Belgian (Flemish) 

16h 

Finnish 

17h 

United Kingdom 

18h 

French/Canadian 

19h 

Swiss/German 

lAh 

Norwegian 

IBh 

French 

ICh 

Danish 

IDh 

Katakana 

lEh 

Latin American/Spanish 

IFh 

United States 


To use the above table, assume the hexadecimal ID number returned is DF. Use the “Device 
Identification Codes” table to determine the type of device being used. Reading down the second 
column of this table you find that the device corresponding to DF is an Extended Keyboard (107- 
109 keys). You next need to determine its nationality since it is a keyboard. To do this, use 
the “Keyboard Nationality Codes” table and the lower 5 bits of the hexadecimal value DF. In 
the case of this example the lower 5 bits are 11111 binary or If hexadecimal. In the table 
IF corresponds to the United States; therefore, the keyboard is designed for use in the United 
States. 
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Describe Record Header — is used to supply additional information about the axes used by 
the device if the device is intended to return coordinates, provides information about the I/O 
Descriptor Byte, and gives information about additional commands used by the device. The 
Describe Record Header is the second hexadecimal value read by the sample program in this 
article and each of the 8 bits of this value represents an important piece of data. The following 
table can be used to interpret this data. 

Description of Describe Record Header 

Bit 7 Set if the device contains two independent sets of coordinate axes. An example of 

two independent sets of HP-HIL devices is a device with two joysticks connected 
to it. Each of the joysticks have their own set of coordinate axes. Note that 
currently joysticks are not supported on HP products. It is assumed, however, 
that both sets of coordinate axes share common characteristics as identified in the 
remainder of the record. Default (clear) indicates a maximum of one set of axes. 

Bit 6 Set if the device is to return absolute positional data (unsigned integers). Default 

(clearl indicates relative data (2’s complement). 

Bit 5 Set i the device returns all positional information at 16-bits/axis. Default (clear) 

is 8-bits/axis. 

Bit 4 Set if the I/O Descriptor Byte is to follow later in the Identify and Describe Record. 

Default (clear) indicates that the device has no buttons, no proximity detection, 
and no prompt/acknowledge functionality, with no I/O Descriptor Byte to follow. 

Bit 3 Set if the device supports the Extended Describe command. This command is 

covered later on in this article. Default (clear) indicates that the Extended Describe 
command is not supported. 

Bit 2 Set if the device supports the Report Security Code command. This command is 

covered later on in this article. Default (clear) indicates that the Report Security 
Code command is not supported. 

Bits 1 and 0 Bits 1 and 0 indicate the coordinate axes the device reports. If nonzero, then 

following the header will be 16 bits or 2 bytes of data describing the resolution 
of the device in counts per centimeter if Bit 5 is set and counts per meter if Bit 
5 is clear. If the device is an absolute positioner, there will be an additional 16 
bits/axis detailing the extent of each coordinate axis. For example, if the HP-HIL 
device has X, Y, and Z axes then there will be a maximum count/axis given for 
the lower and higher bytes of each axis. This is true no matter if the data is being 
report in 8 bit or 16 bit format. To determine the number of axes used by an 
HP-HIL device, use the following table: 
bit 1 bit 0 Axes Reported 

0 0 None 

0 1 X 

1 0 X and Y 

1 1 X, Y, and Z 
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You now have the information necessary for interpreting a Describe Record Header. An example 
using this Identify and Describe Record parameter can be found in the section of this article 
entitled, “Description of the Sample Program’s Data”. 

I/O Descriptor Byte — is used to indicate the buttons the device reports key codes for, whether 
the device has proximity detection, and what Prompt/Acknowledge functions, if any, are im¬ 
plemented in the device. Proximity detection is a way of determining whether the stylus is in 
contact with the X and Y axis sensing device. Note that Prompt and Acknowledge are treated as 
a set, and no device may indicate support of any particular Prompt or Acknowledge without also 
supporting its counterpart. If none of the above features are implemented, the I/O Descriptor 
Byte is not transmitted. The following is the description of this byte: 

Description of Bits for I/O Descriptor Byte 

Bit 7 Set if the device implements the general purpose Prompt and Acknowledge func¬ 

tions. Generally speaking, a Prompt is an audio or visual indication to you that the 
HP-UX system is ready for some form of input, and Acknowledge is an indication 
to you that the input has been received by the HP-UX system. Default (clear) 
implies these functions are not implemented. 

Bits 6, 5, and 4 Indicate specific Prompt/Acknowledges (Prompt 1..7 and Acknowledge 1..7) im¬ 
plemented in the device. Default (clear) indicates none. Use the following table to 
determine Prompt/Acknowledges; 


Bit 6 

Bit 5 

Bit 4 

Prompt/Acks. Implemented 

0 

0 

0 

None 

0 

0 

1 

1 

0 

1 

0 

1 and 2 

0 

1 

1 

1, 2, and 3 

1 

0 

0 

1 .. 4 

1 

0 

1 

1 .. 5 

1 

1 

0 

1 .. 6 

1 

1 

1 

1 .. 7 
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Description of Bits for I/O Descriptor Byte (continued) 


Bit 3 Set if the device reports the Proximity In/Out keycodes. Proximity In/Out key- 

codes describe the stylus or pointers position as it moves into or out of contact 
with an X and Y axis sensing device (e.g. digitizer or touchscreen). Default (clear) 
indicates no proximity detection. Proximity detection is a way of determining 
whether the stylus is in contact with the X and Y axis sensing device. 

Bits 2, 1, and 0 Indicate the buttons for which the device reports keycodes. A button report table 
is given below. 



Button Report 


Bit 2 

Bit 1 

BitO 

Buttons Reported 

0 

0 

0 

None 

0 

0 

1 

1 

0 

1 

0 

1 and 2 

0 

1 

1 

1, 2, and 3 

1 

0 

0 

1 .. 4 

1 

0 

1 

1 .. 5 

1 

1 

0 

1 .. 6 

1 

1 

1 

1 .. 7 


You now have the information necessary for interpreting an I/O Descriptor Byte. An example 
using this Identify and Describe Record parameter can be found in the section of this article 
entitled, “Description of the Sample Program’s Data”. 
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In the description of the Sample Program found in this article, you should recall that the first for 
Jink returned the Identify and Describe Record data and the while link and its internal for link 
returned data read when using the device. To interpret the latter set of data, you need to know 
how to read the information included with the Poll Record Header. The Poll Record Header 
returns information on X, Y, and Z coordinate positions, and key codes sets being used. The 
Poll Record Header bits are assigned as follows: 


Description of the Poll Record Header 


Bit 7 

Set if the device is reporting data from the second set of coordinate axes. Default 
(clear) indicates data from set 1. 

Bits 6 and 5 

Based on the value of these bits, you can determine the data type. The following 
is a table for determining the data type: 


Bit 6 

Bit 5 

Data Type 


0 

0 

No additional data 


0 

1 

Up to 8 bytes ASCII 8-bit data 


1 

0 

Up to 8 bytes Keycode Set 1 data 


1 

1 

Up to 8 bytes Keycode Set 2 data 

Bit 4 

Not implemented. 

Default is clear. 

Bit 3 

Set indicates request for status check. Default (clear) indicates status unchanged. 

Bit 2 

Set indicates device ready for data. Default (clear) indicates not ready for data 
transfer at this time. 

Bits 1 and 0 

Indicate the coordinate axes the device is reporting. The following table provides 
information for determining which axes are to be reported. 


Bit 1 

Bit 0 

Axes Reported 


0 

0 

None 


0 

1 

X 


1 

0 

Xand Y 


1 

1 

X, Y, and Z 


46 Using HP-HIL Devices 





The Poll Record Header is followed by device data. If the device indicated that it would report 
coordinate information as 16-bits/axis in the Describe Record Header, then for each axis reported 
there is a lower byte and then a higher byte coordinate. Otherwise, the higher byte is not 
transmitted. In general, the Poll Record format indicates the maximum data which can be 
reported. Note that most devices only transmit a subset each time. 

Once the positional data has been given, the next set of data provided by the Poll Record is 8 
bytes of Keycode Set 1 or ASCII (8-bit) information, as specified by the Poll Record Header Bits 
5 and 6. 

Perform Self Test (HILPST) 

This command causes the addressed device(s) to perform a self test, returning one data byte 
indicating the results of the test. 

The data byte is 00 (hexadecimal) to indicate a successful test, with non-zero values representing 
device-specific failures. 

Read Register (HILRR) 

The Read Register provides a means for interaction with more complex devices via HP-HIL, 
allowing for types of data transfer not generally supported by the HP-HIL devices. 

A device indicates support of the Read Register command in the Extended Describe Record 
(covered later in this article), it also indicates the specific read registers contained in the device. 
To perform a register read, the system transmits a data frame containing the address of the 
register it is to read, followed by the Read Register command. The device, upon receiving the 
command, transmits the contents of the register indicated by the data frame. The following 
diagrams illustrate this process. 

System sends: 


Device responds: 


Register Address 


Register Data 


Devices which do not support the Read Register command discard all data frames. 
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Write Register (HILWR) 

Write Register provides a means of setting the contents of individual registers in devices sup¬ 
porting this advanced feature, as well as providing the means for transmitting a large amount of 
data to a device at speeds approaching the links maximum of 6 500 bytes/second. 

There are two forms of the Write Register command which may be used separately or mixed in 
the proper order to provide the maximum degree of flexibility. Devices indicate support of either 
of these two forms (or both) in the Extended Describe Record. To write to individual registers 
in a device, the system transmits the register address, followed by the intended contents of 
that register. This is called Write Register Type 1. Several register address/data pairs may be 
transmitted in sequence. 

System sends: 
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The system may also wish to write several bytes to a single register in sequence, utilizing Write 
Register Type 2. Type 2 transfers are sent to the device by setting the most significant bit 
in the byte containing the register address, followed by as many data frames as desired (up to 
the maximum Write Buffer Length of the device, reported in the Extended Describe Record). 
Although it is possible to write several bytes to the same register using Type 1 transfers in devices 
supporting both types (repeating the register address before each byte of data), the intention of 
the two types of data transfers is quite different, and use of Type 2 is recommended. Write 
Register Type 2 has the following format: 


System Sends: 
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The two formats may also be mixed for devices supporting both Write Register Type 1 and Type 
2. There is, however, the restriction that all writes to individual registers occur first, because 
once the device detects the most significant bit in the register address byte to be set it assumes 
all following data frames to be data for that register. The following diagram illustrates the mixing 
of the two Types. 

System sends: 



Devices which do not support the Write Register command will discard all data frames. 
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Report Name (HILRN) 

Report Name is used to request a string of up to 15 characters (8-bit ASCII) which would aid 
in describing the device to the user. Devices indicate support of the Report Name command in 
the Extended Describe Record. 

Report Status (HILRS) 

Report Status is used to extract device-specific status information from devices configured on 
the link. Devices indicate support of the Report Status command in the Extended Describe 
Record. Devices supporting the command respond with from 1 to 15 bytes of device-specific 
status information. Interpretation of the status bytes will necessarily depend upon the device in 
question. 

Extended Describe (HILED) 

Support of the Extended Describe command is indicated in the Describe Record header. It 
provides additional information concerning more advanced device features which may not be 
required for basic operation. 
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Devices supporting the Extended Describe command respond with a series of data types referred 
to as the Extended Describe Record. The record length may vary from 1 to 15 bytes (although 
only 5 bytes are currently defined). The Extended Describe Record has the following format: 


Extended Describe Record Header 
0 Maximum Read Register Supported 

0 Maximum Write Register Supported 

Maximum Write Buffer Length Low Byte 
Maximum Write Buffer Length High Byte 


Devices responding to the Extended Describe command return at least 1 byte of data, the 
Extended Describe Record Header. Devices supporting Read Register to Write Register will 
need to report additional information so that their capabilities may be more fully defined. The 
Extended Describe Record Header both supplies some of the parameters of the device and 
provides an indication of how much additional information is to follow. The meanings of the 
individual bits in the Header are as follows: 


Description of Extended Describe Record Header 


bit 7 and 6 

Reserved for future use. Default will be clear. 

bit 5 

Set if the Report Status command is supported. Default (clear) indicates Report 
Status not supported. 

bit 4 

Set if the Report Name command is supported. Default (clear) indicated Report 
Name not supported. 

bit 3 

Reserved for future use. Default will be clear. 

bit 2 

Set if Read Register supported. If set, immediately following the Header is a 
byte indicating the registers supported for reading in the device. Default is clear, 
indicating Read Register not supported. 

bits 1 and 0 

Bit 1 and bit 0 indicate support of the Write Register command. If bit 1 is set. 
Write Register Type 2 is supported by the device. If bit 0 is set. Write Register 
Type 1 is supported. If both bits are set, then the device supports both Type 1 
and Type 2. If either bit 1 or bit 0 is set, then following in the Record will be 
information indicating the registers supported for writing in the device. If bit 1 is 
set, then an additional 16 bits will be returned indicating the maximum number 
of data bytes which may be written to the device at a time using Write Register 
Type 2 without data loss. 
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If the device indicated support for the Read Register command in the Header, then following 
the Header is a byte indicating the read registers supported by the device. The maximum Read 
Register supported byte indicates the largest read register address supported. Note that it is 
assumed that all addresses less than this maximum are also supported. Thus a byte of OFh 
indicates that the device contains 16 read registers, addressed as read registers 0..15. HP-HIL 
protocol allows for devices containing up to 128 read registers, addressed as 0..127. 

If Write Register (Type 1 or Type 2) support is indicated, then next is a byte indicating the 
write registers supported. The maximum Write Register supported byte indicates the largest 
write register address supported in the device. It is assumed that all addresses less than the 
maximum are also supported. Up to 128 write registers, addressed as 0..127, are supported in 
the HP-HIL protocol. 

If Write Register Type 2 is supported, as indicated by bit 1 of the Extended Describe Record 
Header being set, then following the maximum Write Register supported byte is 16 bits of data 
indicating the maximum number of bytes which may be transmitted to the device in a Type 2 
transfer without overflowing the device’s internal buffer. This number, transmitted first low byte, 
then high byte, represents the buffer length of the device minus 1. Thus a device capable of 
buffering 1024 bytes of data would transmit a maximum Buffer Length Low Byte of FFh and a 
maximum Buffer Length High Byte of 03h. 

Report Security Code (HILSC) 

The Report Security Code command is used to extract a unique identifier from the device. 
Support of the command is indicated in the Describe Record Header. The security code is a 
series of from 1 to 15 bytes which uniquely identify the device in question. Similar in purpose 
to a serial number, it may also contain information related to user identity, network address, or 
other information which is unique to a particular user or environment. 

The only data transmitted by the ID Module is in response to the Report Security Command 
and a self test command. 

The Report Security command invokes a data response according to the HP-HIL specifications. 
The following information applies to any device that supports the report security command. 

The data format consists of a one byte header and eight bytes of binary data. The eight data 
bytes are the packed product and serial numbers of the HP-HIL device. In the case where ID 
Module is an exchange module signified by a ten digit part number, the five digit prefix number 
remains the same and the product number letter is replaced by the least significant digit of the 
part number. 
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The product, exchange and serial number formats are: 


Header 

: H 

(1 byte header) 

Product number is 

: DDDDDA 

(5 digits and 1 ASCII character) 

Exchange part number 

: DDDDDd 

(5 digits and 1 ASCII character) 

Serial number is 

: YYWW@NNNNN 

(9 digits and 1 ASCII character) 


where: 

H is the data header. 

DDDDD is the product number (e.g. 46084). 

A is the product number alpha character. 

d is the least significant numeric character of the exchange number. 

YY is the year code (year less 60). 

WW is the week code (0 to 51). 

@ is the serial country of manufacturing code. 

NNNNN is the serial suffix (0 to 99 999) 

The header byte is transmitted before the eight data bytes. The header’s purpose is to allow 
for other data formats, however none are currently implemented. 

The five digits of the product or exchange part prefix number are converted to a two byte binary 
number and the high order bit of a third byte. The remaining lower seven bits of the third byte 
contain the ASCII character. In products where two alpha characters are used in the product 
number, only the first character is used in the data format. The order of the bytes have been 
arranged to transmit the least significant byte of the number first. 

In a similar manner, the nine digits of the serial number are converted to a four byte binary 
number. The country code of manufacturing is in the last byte to be transmitted and is an ASCII 
character. 

The Report Security data bytes are transmitted starting with byte 1 and going through byte 9. 
Bits are numbered starting with bit 0 at the right most position of the byte (least significant bit) 
and going through bit 7 (most significant bit), left most position. 
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The report security data format is: 


Byte 

Bit 

Description 

1 

7-0 

The first byte is the header containing the number 10 hexadecimal for the following 
format. The general scheme for the header is: 

Bits 7 - 4 are assigned as format variations, where 
format 1 is the only assignment. 

Bits 3 - 0 are undefined, but set to zero. 

2 

7-0 

The second and third bytes and the 7th bit of the fourth byte represent the 5 digits of 

3 

7-0 

the product or exchange part number DDDDD in binary form. The least significant bit 


7 

is bit 0 of byte two. 

4 

6-0 

The least significant seven bits of byte four represent the product letter or the least 
significant digit of the exchange number numeric character. The character is the US 
ASCII 7 bit representation of the character. 

5 

7-0 

The fifth, sixth, seventh bytes and the six least significant bits of byte eight represent 

6 

7-0 

the 9 digits of the serial number YYWWNNNNN in binary form, without the alpha 

7 

7-0 

character. The least significant bit is bit 0 of byte 5. 

8 

5-0 


8 

7-6 

The two most significant bits of byte eight are reserved for future use and are set to 

zero. 

9 

6-0 

The least significant seven bits of byte 9 represent the serial number letter. The character 
is the US ASCII 7 bit representation of the character. 

9 

7 

The most significant bit of byte nine is reserved for future use and is set to zero. 
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Sample of Report Security Format for A Product Module 

The following information is returned upon receiving a Report Security command for a Product 
Module. The data is based on the data format described in the last section. Byte 1 is the first 
byte sent from the module to the host. 

The sample results given are based on the product number 46084A and serial number 
2519A00001. The serial number corresponds with the year of 1985, week 19, and serial 
number suffix 00001. Note that by adding 60 to the above serial numbers first two digits you 
get the year 85. 


Byte No. 

Data (hex) 

Description 

1 

10 

Header 

2 

04 

Part of product number 46084 

3 

B4 

Part of product number 46084 

4 

41 

Product letter “A” and part of product number 46084 

5 

61 

Part of serial number 

6 

BO 

Part of serial number 

7 

03 

Part of serial number 

8 

OF 

Part of serial number 

9 

41 

Country of Manufacturing Code 
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Sample of Report Security Format for An Exchange Module 

The following information is returned upon receiving a Report Security command for an Exchange 
Module. The data is based on the data format described in the section, “Report Security Code 
(HILSC)”. Byte 1 is the first byte sent from the module to the host. 

The sample results given are based on the exchange number 46084-69901 and serial number 
2519A00001. The serial number corresponds with the year of 1985, week 19, and serial 
number suffix 00001. Note that by adding 60 to the above serial numbers first two digits you 
get the year 85. 


Byte No. 

Data (hex) 

Description 

1 

10 

Header 

2 

04 

Part of product number 46084 

3 

B4 

Part of product number 46084 

4 

31 

US ASCII character “1” which is part of the product number 460841 

5 

61 

Part of serial number 

6 

BO 

Part of serial number 

7 

03 

Part of serial number 

8 

OF 

Part of serial number 

9 

41 

Country of Manufacturing Code 


Since the sample is an exchange module, the exchange part number transmitted is 460841. 
Byte 4 is the hexadecimal value of 31 which represent the US ASCII character “1”. Note, the 
prefix number 46084 does not change from the sample of the product module and the character 
“1” is really an ASCII character. When the number is displayed, the character string “-6990” 
should be inserted into the part number at the appropriate place. 

Sample Report Security Program 

This program returns information upon receiving a Report Security command for a Product 
Module. The data is based on the data format described at the beginning of the section, “Report 
Security Code (HILSC)”. Byte 1 is the first byte sent from the module to the host. 

The sample results given are based on the product number 46084A and serial number 
2519A00093. The serial number corresponds with the year of 1985, week 19, and serial 
number suffix 00093. Note that by adding 60 to the above serial numbers first two digits you 
get the year 85. 
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The sample program is as follows: 


1 #include <sys/hilioctl.h> 

2 #define BUF.SIZ 15 

3 #define MAX.DEV 

4 

5 unsigned char dev_name[] = { "/dev/hill" >; 

6 


7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 


mainO 

extern int errno; 

int index, hil_fd, product_no, serial.no, 

serial^hi, serial.lo; 

unsigned char hil_info[BUF_SIZ], product_let, country; 


while (dev.name[8] <= MAX_DEV) 

{ 

printf("\n") 
if((hil_fd = 

-C 

printf CyoS 


/* device search link */ 


open(dev_name,0)) > 0) 


/* open device file. */ 

/* print device file name. */ 


,dev_name); 

if(ioctl(hil_fd,HILID.hil_info) < 0) 

printf("ioctl error %d\n",errno); /* invalid ioctl call. */ 
else 

for(index = 0; index < BUF_SIZ; printf(" %.2X",hil_info[index++])) 
; /* print id desc info. */ 

printf("\n"); 

if((hil_info[l] & ~(~04)) == 04) 

printf(" ID NUMBER: "); 
if(ioctl(hil_fd.HILSC.hil_info) 
printf ("ioctl error y*d\n", errno); 
else 

for(index = 0; index < BUF_SIZ - 
hil_info[index++])) /* 


/* if dev reports sec code. */ 


0) /* return sec code. */ 

/* invalid ioctl call. */ 


6; printf(" ye.2X". 
print security code. */ 


printf("\n"); 

product_no = hil_info[l] I hil.info [2] << 8 I 
(hil^info[3] » 7) « 16; 
product.let = hil_info[3] & 0x7f; 
serial_no = hil_info[4] | hil_info[5] << 8 I 

hil_info[6] « 16 I (hil_info[7] & 0x3f) « 24; 
serial_hi = serial_no/100000; 
serial_lo = serial_no - serial_hi * 100000; 
country = hil_info[8] & 0x7f; 

printf (" product number = y,uyoC" ,product_no,product_let); 
printf (" serial number = “/cuyocyo. 5u\n" , 
serial_hi,country,serial_lo); 
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49 > 

50 } 

51 > 

52 close(hil_fd); 

53 } 

54 else printfCyoS - open error: 

55 

56 ++(dev_name[8]); 

57 } 

58 } 


*yid\n", dev_name, errno) ; 

/* unable to open dev file. 
/* select next device file. 


*/ 

*/ 


The following is an explanation of the program: 

Line 1 provides the include file (sys/hilioctl .h) which contains a list of macros that execute 
specific functions when used within a C Language program. HILID and HILSC are two macros 
which are included in this file and are used in this program. The path name for the hilioctl.h file 
is /usr/include/sys/hilioctl.h. If you execute the cat or more command on this path name, you 
will receive a screen listing of this file’s contents. 

Lines 2 and 3 define the constants BUF_SIZ and MAX_DEV. BUF.SIZ is assigned the value of 
15 and MAX_DEV is assigned the value of 7. 

Line 5 assigns the character string “/dev/hill” to the unsigned character array dev_name. 

Lines 9 through 12 declare the variables used in the program. These variables are defined as 
follows: 

• errno is the external variable that receives the error number if there is an invalid ioctl call 
made. 

• index is the control variable used in the for loops of lines 25 and 35. 

• hil.fdis the file descriptor used in the ioctl parameter fields. 

• product_no is the product number of the ID Module being used. 

• serial_no is the serial number of the ID Module being used. 

• serial_hi is the higher order set of bits being manipulated to interpret the serial number. 

• serial.lois the lower order set of bits being manipulated to interpret the serial number. 

• hil_info is the unsigned character array which is assigned information return from the 
HP-HIL device. 
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• product.let is the product letter suffixed to the product number of the HP-HIL ID Module. 

• country is the unsigned character which designates the country of the manufacturing code 
for the HP-HIL ID Module. 

Line 14 is a HP-HIL device search link (while link) which tries to open an HP-HIL device file. 
If the device file can be opened it continues with the remainder of the while link; otherwise, it 
prints an error message (line 54) and increments the eighth element (line 56) of the character 
string dev.name and searches for a new device. 

Line 17 is an IF construct which tries to open the file dev.name. If the file can be opened the 
variable hil.id is assigned the file descriptor returned from opening the file. If the dev.name 
can not be opened then an error message (line 54) is displayed and the eighth element of the 
character array dev.name is incremented by one (line 56). The while link then searches for the 
next HP-HIL device. 

Line 19 prints the device file name. 

Line 20 checks for a valid ioctl call. If it is valid the program continues from the else statement 
with the next set of instructions; otherwise, an error message is displayed (line 21). 

Line 24 is a for link which displays the describe record information after the label created by 
line 19. 

Line 27 test to see if the device is an ID Module if it is not an ID Module then nothing is printed 
and the while link searches for the next device. However, if the device is an ID Module then the 
program continues by making an ioctl call using the macro HILSC. 

Line 29 displays the label ID NUMBER. 

Line 30 test for a valid ioctl call. If the call made is invalid then an error message is displayed 
(line 31). If the call made was valid then the program continues. 

Lines 34 and 35 are a for link which displays the hexadecimal value of the Security Code after 
the ID NUMBER label. 

Lines 37 through 48 make up the remainder of the if-then-else statement. Their purpose is to 
unscramble the Security Code information by performing several bit manipulations on the data. 
The result of all this bit manipulation is a readable product number and serial number being 
displayed. 
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A sample display would appear as follows assuming that an ID Module is the first device in the 
HP-HIL link, an Extended Keyboard is the second device in the HP-HIL link, and a Two-button 
Mouse is the third device in the HP-HIL link. Note that the remaining devices shown in the 
display indicate an open error. This is because these devices did not exist in the HP-HIL link. 


/dev/hill -34 04 00 00 00 00 00 00 00 00 00 00 
ID NUMBER: 10 04 B4 41 BD BO 03 OF 41 
product number = 46084A serial number = 


/dev/hil2 

/dev/hil3 

/dev/hil4 

/dev/hil5 

/dev/hil6 

/dev/hil7 


-DF 00 00 00 00 00 00 00 00 00 00 00 

-68 12 C2 IE 02 00 00 00 00 00 00 00 

- open error: 6 

- open error: 6 

- open error: 6 

- open error: 6 


00 00 00 
2519A00093 
00 00 00 
00 00 00 


The hexadecimal information displayed after each of the device file names shown above can 
be interpreted by reading the section in the article entitled, “Identify and Describe Command 
(HILID)”. 

Disable Keyswitch Auto-repeat (HILDKR) 

This command is used to disable the “repeating keys” feature in the addressed device, reducing 
returned data to one report per keyswitch transition. 

Enable Keyswitch Auto-repeat 1 and 2 (HILER1 and HILER2) 

These two commands are used to enable the “repeating keys” feature in the addressed device 
(if the feature is supported). Generally keys repeat at the rate of one report every 1/30 of a 
second (based on a system poll rate of 1/60 of a second). Some keys, termed “Modifier” keys, 
will not repeat, while based on the opcode of the Enable Keyswitch Auto-repeat command the 
Cursor Keys (cursor left, right, up and down) will repeat at either 1/30 of a second interval 
(opcode 3Eh) or 1/60 of a second intervals (opcode 3Fh). Most keys “repeat” by generating 
repeated down transitions corresponding to the key position being repeated, although repeating 
cursor keys report a key code of 02h. 
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Prompt 1 through Prompt 7 (HILP1 through HILP7) 

These commands are used to provide an audio or visual stimulus to the user, perhaps indicating 
that the system is ready for a particular type of input. Although intended to be directly associated 
with Acknowledge 1 through Acknowledge 7 and Button 1 through Button 7, this association 
is not a requirement. 

The Prompts supported by the device are indicated in the Describe Record, and all unsupported 
Prompts will be treated the same as other unsupported commands. 

Prompt (HILP) 

Intended as a general-purpose stimulus to the user. Prompt is not intended to be associated with 
a particular Button as are Prompt 1 through Prompt 7. A device indicates support of Prompt 
in the Describe Record. 

Acknowledge 1 through Acknowledge 7 (HILA1 through HILA7) 

These commands, though similar to the Prompt 1 through Prompt 7 commands, are intended 
to provide an audio or visual response to the user, and are generally directly associated with 
the corresponding Prompt and Button of the same number, although this is not a requirement. 
Unsupported Acknowledge commands are ignored. Since there is no explicit “Prompt Off” 
function provided, this functionality may be part of the Acknowledge definition for a particular 
device, if required. 

Acknowledge (HILA) 

This command is similar to Prompt, however, Acknowledge is not associated with any particular 
Button, but merely as a general purpose audio or visual response to the user. 
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Keycode Set 1 

This section provides the table, “Keycode Set 1”. 


Kcycode Set 1 


Keycode for 
Transition (hex) 

United States 

Legend 

Down 

Up 

Unshifted 

Shifted 

OOh 

Olh 

5 


+ Char 

02h 

03h 

< Repeat Cursor > 

3 


04h 

05h 

Extend Char 

(right) 


06h 

07h 

Extend Char 

(left) 


08h 

09h 

Shift 

(right) 


OAh 

OBh 

Shift 

(left) 


OCh 

ODh 

CTRL 



OEh 

OFh 

Break 


Reset 

lOh 

llh 

4 

(keypad) 


12h 

13h 

8 

(keypad) 


14h 

15h 

5 

(keypad) 


16h 

17h 

9 

(keypad) 


18h 

19h 

6 

(keypad) 


lAh 

IBh 

7 

(keypad) 


ICh 

IDh 

, 

(keypad) 


lEh 

IFh 

Enter 

(keypad) 


20h 

21h 

1 

(keypad) 


22h 

23h 

/ 

(keypad) 


24h 

25h 

2 

(keypad) 


26h 

27h 

+ 

(keypad) 


28h 

29h 

3 

(keypad) 


2Ah 

2Bh 

* 

(keypad) 


2Ch 

2Dh 

0 

(keypad) 


2Eh 

2Fh 

- 

(keypad) 


30h 

31h 

B 




33h 

V 




35h 

c 



36h 

.37h 

X 



38h 

39h 

z 



3Ah 

3Bh 

<NOT LOADED>^ (left) 


3Ch 

3Dh 

<NOT USED> 



3Eh 

3Fh 

ESC 




^ Keycode 02h reserved for Cursor Repeat. 

NOT LOADED key positions are located next to the Extend Char keys, below the Shift keys, and are generally covered by non-operative 
filler keys. 
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Keycode Set 1 (continued) 
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Keycode Set 1 (continued) 
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Keycode Set 1 (continued) 


Keycode for 
Transition (hex) 

United States 

Legend 

Down 

Up 

Unshifted 

Shifted 

COh 

Clh 

I 


C2h 

C3h 

0 


C4h 

C5h 

P 


C6h 

C7h 

[ 

{ 

C8h 

C9h 

1 

} 

CAh 

CBh 

\ 

1 

CCh 

CDh 

Insert char 


CEh 

CFh 

Delete char 


DOh 

Dlh 

J 


D2h 

D3h 

K 


D4h 

D5h 

L 


D6h 

D7h 

; 


D8h 

D9h 

’ 


DAh 

DBh 

Return 


DCh 

DDh 

<home cursor> 


DEh 

DFh 

Prev 


EOh 

Elh 

M 


E2h 

E3h 


< 

E4h 

E5h 


> 

E6h 

E7h 

/ 

? 

E8h 

E9h 

<NOT USED> 


EAh 

EBh 

Select 


ECh 

EDh 

<NOT USED> 


EEh 

EFh 

Next 


FOh 

Flh 

N 


F2h 

F3h 

< space bar> 


F4h 

F5h 



F6h 

F7h 

<NOTLOADED>® (right) 


F8h 

F9h 

<left cursor> 


FAh 

FBh 

<down cursor > 


FCh 

FDh 

<up cursor > 


FEh 

FFh 

< right cursor > 



5 


NOT LOADED key positions are located next to the Extend Char keys, below the Shift keys, and are generally covered by non-operative 
filler keys. 
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f 
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FORTRAN . 16 
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h 
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HILED . 37, 38 

HILERl . 37, 38, 60 
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HILID. 19, 26, 30, 32, 37, 38, 39, 58 

Hilkdb . 10, 11 

HILP. 37, 38, 61 

HILP1..HILP7 . 37, 38, 61 
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HILRS . 37, 38, 50 
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Interface . 1 
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Keyboard Nationality Codes . 41 
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Peripheral processor . 1 
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Touch Bezel.4 
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I 

Identification Codes, HP-HIL Device . 40 

Identify and Describe Command (HILID). 39 

ID Module.52 
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n 
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O 

Open . 17 

p 
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Pascal Program, Explanation . 25 
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Path name.8 

Pc. 16 
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70 Index 






























Prompt/Acknowledge function . 43 

Prompt (HILP) . 61 

Proximity detection . 43 
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Report Security Data Format.54 

Report Security Format for An Exchange Module, Sample . 56 
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Report Security Program, Sample . 56 

Report Status (HILRS).50 

RESET (Pascal) . 21 

Rotary Control Knob . 5 

S 

Sample Programs Data, Description of . 32 

Security Data Format, Report . 54 

Select code . 8 

Special (device) files . 7, 8 

Special (device) files. Creating . 9 

Sprintf . 21, 26, 27 

STANDARD.LEVEL . 21, 25 

SYSPROG ON. 21, 25 

t 

Two-Button Mouse.4, 16, 32 

TYPE.COERCION . 21, 25 

V 

Vectra Personal Computer . 3 

w 

Write Register (HILWR) . 47 

Write Register Type 1 . 48, 49, 52 
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